Gcp/testing

@swamp/gcp/testingv2026.08.12.2· 11d agoMODELS

01README

Google Cloud testing infrastructure models

02Release Notes

Updated: devicesessions, testmatrices, testenvironmentcatalog

03Models3

@swamp/gcp/testing/devicesessionsv2026.08.12.2devicesessions.ts

Global Arguments

Argument	Type	Required	Description
accessToken?	string	no	GCP OAuth2 access token; overrides GCP_ACCESS_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
credentialsJson?	string	no	GCP service account JSON credentials; overrides GOOGLE_APPLICATION_CREDENTIALS_JSON environment variable. Wire with a vault.get(...) expression to source it from a vault.
project?	string	no	GCP project ID; overrides GCP_PROJECT / GOOGLE_CLOUD_PROJECT environment variables.
scopes?	string	no	Comma-separated OAuth scopes to request when minting access tokens via gcloud. Defaults to the API's Discovery Document scopes.
quotaProject?	string	no	GCP project ID for quota and billing attribution; sets the x-goog-user-project header. Overrides GOOGLE_CLOUD_QUOTA_PROJECT environment variable. Required for APIs like Cloud Identity when using user credentials.
apiEndpoint?	string	no	Custom API endpoint for emulators; overrides GCP_API_ENDPOINT environment variable. Defaults to the service's production URL.
androidDevice?	object	no	Required. The requested device
expireTime?	string	no	Optional. If the device is still in use at this time, any connections will be ended and the SessionState will transition from ACTIVE to FINISHED.
name?	string	no	Optional. Name of the DeviceSession, e.g. "projects/{project_id}/deviceSessions/{session_id}"
ttl?	string	no	Optional. The amount of time that a device will be initially allocated for. This can eventually be extended with the UpdateDeviceSession RPC. Default: 15 minutes.
location?	string	no	The location for this resource (e.g., 'us', 'us-central1', 'europe-west1')

fn create(waitForReady?: boolean)

Create a deviceSessions

Argument	Type	Required	Description
waitForReady?	boolean	no	Wait for the resource to reach a ready state after creation (default: true)

fn get(identifier: string)

Get a deviceSessions

Argument	Type	Required	Description
identifier	string	yes	The name of the deviceSessions

fn update(identifier?: string, waitForReady?: boolean)

Update deviceSessions attributes

Argument	Type	Required	Description
identifier?	string	no	Target a specific deviceSessions by name (e.g. one discovered by list)
waitForReady?	boolean	no	Wait for the resource to reach a ready state after update (default: true)

fn sync(identifier?: string)

Sync deviceSessions state from GCP

Argument	Type	Required	Description
identifier?	string	no	Target a specific deviceSessions by name (e.g. one discovered by list)

fn list(filter?: string, pageSize?: number, maxPages?: number)

List deviceSessions resources

Argument	Type	Required	Description
filter?	string	no	Optional. If specified, responses will be filtered by the given filter. Allowed fields are: session_state.
pageSize?	number	no	Optional. The maximum number of DeviceSessions to return.
maxPages?	number	no	Maximum number of pages to fetch (default: 10)

fn cancel()

cancel

Resources

state(infinite)— Protobuf message describing the device message, used from several RPCs.

@swamp/gcp/testing/testenvironmentcatalogv2026.08.12.2testenvironmentcatalog.ts

Global Arguments

Argument	Type	Required	Description
name	string	yes	Instance name for this resource (used as the unique identifier in the factory pattern)
accessToken?	string	no	GCP OAuth2 access token; overrides GCP_ACCESS_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
credentialsJson?	string	no	GCP service account JSON credentials; overrides GOOGLE_APPLICATION_CREDENTIALS_JSON environment variable. Wire with a vault.get(...) expression to source it from a vault.
project?	string	no	GCP project ID; overrides GCP_PROJECT / GOOGLE_CLOUD_PROJECT environment variables.
scopes?	string	no	Comma-separated OAuth scopes to request when minting access tokens via gcloud. Defaults to the API's Discovery Document scopes.
quotaProject?	string	no	GCP project ID for quota and billing attribution; sets the x-goog-user-project header. Overrides GOOGLE_CLOUD_QUOTA_PROJECT environment variable. Required for APIs like Cloud Identity when using user credentials.
apiEndpoint?	string	no	Custom API endpoint for emulators; overrides GCP_API_ENDPOINT environment variable. Defaults to the service's production URL.

fn get(identifier: string)

Get a testEnvironmentCatalog

Argument	Type	Required	Description
identifier	string	yes	The name of the testEnvironmentCatalog

fn sync(identifier?: string)

Sync testEnvironmentCatalog state from GCP

Argument	Type	Required	Description
identifier?	string	no	Target a specific testEnvironmentCatalog by name (e.g. one discovered by list)

Resources

state(infinite)— A description of a test environment.

@swamp/gcp/testing/testmatricesv2026.08.12.2testmatrices.ts

Global Arguments

Argument	Type	Required	Description
name	string	yes	Instance name for this resource (used as the unique identifier in the factory pattern)
accessToken?	string	no	GCP OAuth2 access token; overrides GCP_ACCESS_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
credentialsJson?	string	no	GCP service account JSON credentials; overrides GOOGLE_APPLICATION_CREDENTIALS_JSON environment variable. Wire with a vault.get(...) expression to source it from a vault.
project?	string	no	GCP project ID; overrides GCP_PROJECT / GOOGLE_CLOUD_PROJECT environment variables.
scopes?	string	no	Comma-separated OAuth scopes to request when minting access tokens via gcloud. Defaults to the API's Discovery Document scopes.
quotaProject?	string	no	GCP project ID for quota and billing attribution; sets the x-goog-user-project header. Overrides GOOGLE_CLOUD_QUOTA_PROJECT environment variable. Required for APIs like Cloud Identity when using user credentials.
apiEndpoint?	string	no	Custom API endpoint for emulators; overrides GCP_API_ENDPOINT environment variable. Defaults to the service's production URL.
clientInfo?	object	no	Information about the client which invoked the test.
environmentMatrix?	object	no	Required. The devices the tests are being executed on.
failFast?	boolean	no	If true, only a single attempt at most will be made to run each execution/shard in the matrix. Flaky test attempts are not affected. Normally, 2 or more attempts are made if a potential infrastructure issue is detected. This feature is for latency sensitive workloads. The incidence of execution failures may be significantly greater for fail-fast matrices and support is more limited because of that expectation.
flakyTestAttempts?	number	no	The number of times a TestExecution should be re-attempted if one or more of its test cases fail for any reason. The maximum number of reruns allowed is 10. Default is 0, which implies no reruns.
projectId?	string	no	The cloud project that owns the test matrix.
resultStorage?	object	no	Required. Where the results for the matrix are written.
testSpecification?	object	no	Required. How to run the test.
requestId?	string	no	A string id used to detect duplicated requests. Ids are automatically scoped to a project, so users should ensure the ID is unique per-project. A UUID is recommended. Optional, but strongly recommended.

fn create(waitForReady?: boolean)

Create a testMatrices

Argument	Type	Required	Description
waitForReady?	boolean	no	Wait for the resource to reach a ready state after creation (default: true)

fn get(identifier: string)

Get a testMatrices

Argument	Type	Required	Description
identifier	string	yes	The name of the testMatrices

fn sync(identifier?: string)

Sync testMatrices state from GCP

Argument	Type	Required	Description
identifier?	string	no	Target a specific testMatrices by name (e.g. one discovered by list)

fn cancel()

cancel

Resources

state(infinite)— TestMatrix captures all details about a test. It contains the environment con...

04Previous Versions19

2026.07.29.1Jul 30, 2026

Updated: devicesessions, testmatrices, testenvironmentcatalog

2026.07.21.3Jul 21, 2026

Updated: devicesessions, testmatrices, testenvironmentcatalog

2026.07.21.1Jul 21, 2026

Updated: devicesessions, testmatrices

2026.07.20.1Jul 20, 2026

Updated: devicesessions, testmatrices, testenvironmentcatalog

2026.07.19.1Jul 19, 2026

Updated: devicesessions, testmatrices, testenvironmentcatalog

2026.07.18.2Jul 18, 2026

Updated: devicesessions, testmatrices, testenvironmentcatalog

2026.07.17.2Jul 17, 2026

Updated: devicesessions

2026.07.17.1Jul 17, 2026

Updated: devicesessions, testmatrices

Added 3, removed 1 models

2026.06.08.2Jun 8, 2026

Updated: devicesessions, testmatrices, testenvironmentcatalog

2026.06.07.1Jun 7, 2026

Updated: devicesessions, testmatrices, testenvironmentcatalog

2026.05.25.1May 25, 2026

Updated: devicesessions, testmatrices, testenvironmentcatalog

Modified 1 models

2026.05.24.1May 24, 2026

Updated: devicesessions, testmatrices, testenvironmentcatalog

2026.05.21.2May 21, 2026

Updated: devicesessions, testmatrices, testenvironmentcatalog

2026.05.21.1May 21, 2026

2026.05.19.2May 19, 2026

2026.05.19.1May 19, 2026

2026.05.18.1May 18, 2026

2026.04.23.1Apr 23, 2026

2026.04.04.1Apr 4, 2026

Updated: testmatrices, testenvironmentcatalog

05Stats

100 / 100

Downloads

Archive size

70.0 KB

Verified by Swamp

Has README or module doc2/2earned
README has a code example1/1earned
README is substantive1/1earned
Most symbols documented1/1earned
No slow types (deprecated)1/1earned
Dependencies pass trust audit2/2earned
Has description1/1earned
Platform support declared (or universal)2/2earned
License declared1/1earned
Verified public repository2/2earned

Repository

https://github.com/swamp-club/swamp-extensions

06Platforms

linux · x86_64 linux · aarch64 macOS · x86_64 macOS · aarch64

07Labels

#gcp #google-cloud #testing #cloud #infrastructure