@microagi/alchemy-gcp 0.1.2

package/lib/Container/Operations.js

@@ -0,0 +1,51 @@
+import { ConfigError } from "@distilled.cloud/gcp";
+import * as Duration from "effect/Duration";
+import * as Effect from "effect/Effect";
+import * as Schedule from "effect/Schedule";
+/**
+ * Qualify a GKE operation name. The Container API returns
+ * `Operation.name` as a bare ID like `operation-1778057673333-...`,
+ * but `getProjectsLocationsOperations` expects the fully-qualified
+ * path `projects/{p}/locations/{l}/operations/{id}`. Already-qualified
+ * names are passed through unchanged so callers can stay agnostic.
+ *
+ * (CRM operations don't need this because CRM returns names as
+ * `operations/...` and its `getOperations` takes the bare path
+ * directly.)
+ */
+export const qualifyOperationName = (project, location, name) => name.startsWith("projects/")
+    ? name
+    : `projects/${project}/locations/${location}/operations/${name}`;
+/**
+ * Build the GKE long-running-operation polling helper.
+ *
+ * Container `Operation`s carry `.status: "PENDING" | "RUNNING" | "DONE"
+ * | "ABORTING"` (NOT `.done: boolean` like Cloud Resource Manager —
+ * verified at `vendor/distilled/packages/gcp/src/services/container-v1.ts:919–976`).
+ * The doneness predicate compares `.status === "DONE"` accordingly.
+ *
+ * Schedule: exponential 2s → 1.5× growth, capped per-poll at 15s via
+ * `Schedule.either`, then a hard count cap of 80 retries via
+ * `Schedule.both(Schedule.recurs(80))` → ~20 min wall ceiling, well
+ * above the worst observed GKE op time (cluster create runs 5–10 min).
+ *
+ * The helper is a factory — the caller resolves
+ * `cont.getProjectsLocationsOperations` once at provider construction
+ * (see `Project.ts` for the same idiom) and passes the resulting
+ * callable here, so we never re-resolve services on each await.
+ */
+export const makeAwaitOperation = (getOperations) => Effect.fn(function* (operationName, session) {
+    const op = yield* getOperations({ name: operationName }).pipe(Effect.flatMap((current) => current.status === "DONE"
+        ? Effect.succeed(current)
+        : Effect.fail({ _tag: "OperationPending" })), Effect.retry({
+        while: (e) => e?._tag === "OperationPending",
+        schedule: Schedule.exponential(Duration.seconds(2), 1.5).pipe(Schedule.either(Schedule.spaced(Duration.seconds(15))), Schedule.both(Schedule.recurs(80)), Schedule.tapOutput(() => session.note(`Waiting for GKE operation ${operationName}…`))),
+    }));
+    if (op.error) {
+        return yield* new ConfigError({
+            message: `GKE operation ${operationName} failed: ${op.error.message ?? JSON.stringify(op.error)}`,
+        });
+    }
+    return op;
+});
+//# sourceMappingURL=Operations.js.map

package/lib/Container/Operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Operations.js","sourceRoot":"","sources":["../../src/Container/Operations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnD,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAE5C;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,OAAe,EACf,QAAgB,EAChB,IAAY,EACJ,EAAE,CACV,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;IAC1B,CAAC,CAAC,IAAI;IACN,CAAC,CAAC,YAAY,OAAO,cAAc,QAAQ,eAAe,IAAI,EAAE,CAAC;AAcrE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,aAA4B,EAAE,EAAE,CACjE,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,EACjB,aAAqB,EACrB,OAAgC;IAEhC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC,IAAI,CAC3D,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CACzB,OAAO,CAAC,MAAM,KAAK,MAAM;QACvB,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;QACzB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,kBAA2B,EAAE,CAAC,CACvD,EACD,MAAM,CAAC,KAAK,CAAC;QACX,KAAK,EAAE,CAAC,CAAoB,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,KAAK,kBAAkB;QAC/D,QAAQ,EAAE,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAC3D,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EACtD,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAClC,QAAQ,CAAC,SAAS,CAAC,GAAG,EAAE,CACtB,OAAO,CAAC,IAAI,CAAC,6BAA6B,aAAa,GAAG,CAAC,CAC5D,CACF;KACF,CAAC,CACH,CAAC;IACF,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC;QACb,OAAO,KAAK,CAAC,CAAC,IAAI,WAAW,CAAC;YAC5B,OAAO,EAAE,iBAAiB,aAAa,YACrC,EAAE,CAAC,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,CAC7C,EAAE;SACH,CAAC,CAAC;IACL,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC,CAAC,CAAC"}

package/lib/Container/index.d.ts

@@ -0,0 +1,5 @@
+export { Cluster, ClusterProvider } from "./Cluster.ts";
+export type { ClusterAttributes, ClusterInitialNodePool, ClusterProps, } from "./Cluster.ts";
+export { NodePool, NodePoolProvider } from "./NodePool.ts";
+export type { NodePoolAttributes, NodePoolProps } from "./NodePool.ts";
+//# sourceMappingURL=index.d.ts.map

package/lib/Container/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Container/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACxD,YAAY,EACV,iBAAiB,EACjB,sBAAsB,EACtB,YAAY,GACb,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC3D,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/lib/Container/index.js

@@ -0,0 +1,3 @@
+export { Cluster, ClusterProvider } from "./Cluster.js";
+export { NodePool, NodePoolProvider } from "./NodePool.js";
+//# sourceMappingURL=index.js.map

package/lib/Container/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/Container/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAMxD,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}

package/lib/Parallelstore/Instance.d.ts

@@ -0,0 +1,119 @@
+import { Resource } from "alchemy";
+import * as Provider from "alchemy/Provider";
+import type { NetworkRef } from "../Compute/Network.ts";
+import type * as GCP from "../Providers.ts";
+/**
+ * A Parallelstore instance — a high-throughput, POSIX-style filesystem
+ * Google sells for AI training/inference shared storage. Backed by DAOS
+ * under the hood; mounted in clusters via the Parallelstore CSI driver.
+ *
+ * **Network preconditions.** The instance attaches to a VPC over PSA
+ * (Private Services Access). The consumer VPC must already have:
+ *   1. A `GCP.GlobalAddress` reservation (`purpose=VPC_PEERING`,
+ *      `addressType=INTERNAL`, ≥/24 prefix length).
+ *   2. A `GCP.PsaConnection` to `servicenetworking.googleapis.com`
+ *      consuming that range.
+ * See the Shared VPC + Parallelstore wiring in the apps/cluster stack.
+ *
+ * **Capacity.** `capacityGib` must be a multiple of 12000 GiB and
+ * between 12000 (12 TiB) and 100800 (98.4 TiB). Smaller deployments
+ * may use 100 GiB increments depending on the SKU; the API surfaces
+ * the floor at create time.
+ *
+ * Parallelstore operations use a CRM-style `Operation.done: boolean`
+ * (verified at `parallelstore-v1.ts`).
+ *
+ * @section Creating a Parallelstore instance
+ * @example 20 TiB scratch instance
+ * ```typescript
+ * const fs = yield* GCP.ParallelstoreInstance("ModelsFs", {
+ *   project: hostProject.projectId,
+ *   location: "us-central1-a",
+ *   capacityGib: "20480",
+ *   network: GCP.networkRef(hostProject.projectNumber, vpc.name),
+ *   reservedIpRange: psaRange.name,
+ *   deploymentType: "SCRATCH",
+ *   fileStripeLevel: "FILE_STRIPE_LEVEL_BALANCED",
+ *   directoryStripeLevel: "DIRECTORY_STRIPE_LEVEL_BALANCED",
+ * });
+ * ```
+ */
+export type ParallelstoreInstanceProps = {
+    /** GCP project ID hosting the instance. Immutable — replace if changed. */
+    project: string;
+    /**
+     * Parallelstore location. **Zone, not region** — Parallelstore is a
+     * zonal product. Common: `us-central1-a`. Immutable — replace.
+     */
+    location: string;
+    /**
+     * Instance ID. Defaults to `createPhysicalName({ id, lowercase: true,
+     * maxLength: 63 })`. Lowercase letters/numbers/hyphens, must start
+     * with a letter, end with a letter or number. Immutable — replace.
+     */
+    instanceId?: string;
+    /** User-visible description. Mutable via `patch`. */
+    description?: string;
+    /**
+     * Capacity in **GiB** (1024-based). Sent to the API as a string per
+     * Parallelstore's int64-encoded-as-string convention. Replace-only —
+     * Parallelstore doesn't currently support online resize.
+     */
+    capacityGib: string;
+    /**
+     * Fully-qualified consumer VPC in project-number form. Build with
+     * `networkRef(project.projectNumber, vpc.name)` — the `NetworkRef`
+     * template literal type rejects project-ID-form strings at compile
+     * time. Immutable — replace.
+     */
+    network: NetworkRef;
+    /**
+     * Name (or self-link) of a `GCP.GlobalAddress` PSA reservation in
+     * the same VPC. Immutable — replace.
+     */
+    reservedIpRange?: string;
+    /** `SCRATCH` (default) or `PERSISTENT`. Immutable — replace. */
+    deploymentType?: "SCRATCH" | "PERSISTENT";
+    /** File stripe level. Replace-only. */
+    fileStripeLevel?: "FILE_STRIPE_LEVEL_MIN" | "FILE_STRIPE_LEVEL_BALANCED" | "FILE_STRIPE_LEVEL_MAX";
+    /** Directory stripe level. Replace-only. */
+    directoryStripeLevel?: "DIRECTORY_STRIPE_LEVEL_MIN" | "DIRECTORY_STRIPE_LEVEL_BALANCED" | "DIRECTORY_STRIPE_LEVEL_MAX";
+    /**
+     * Resource labels. Alchemy internal labels (`alchemy_app`,
+     * `alchemy_stage`, `alchemy_id`) are merged on top automatically.
+     * Mutable via `patch`.
+     */
+    labels?: Record<string, string>;
+};
+export type ParallelstoreInstanceAttributes = {
+    /** Bare instance id. */
+    instanceId: string;
+    /** Project ID. */
+    project: string;
+    /** Zone. */
+    location: string;
+    /** Resource name `projects/{p}/locations/{l}/instances/{id}`. */
+    name: string;
+    /** Description, mirroring props. */
+    description: string | undefined;
+    /** Capacity in GiB. */
+    capacityGib: string;
+    /** Consumer VPC URL (project-number form). */
+    network: NetworkRef;
+    /** Reserved IP range used (server-resolved). */
+    reservedIpRange: string | undefined;
+    /** Effective reserved range (post-allocation). */
+    effectiveReservedIpRange: string | undefined;
+    /** Lifecycle state — `ACTIVE` once ready. */
+    state: string | undefined;
+    /** Active deployment type. */
+    deploymentType: string | undefined;
+    /** DNS access points VMs mount via. */
+    accessPoints: ReadonlyArray<string>;
+    /** Labels currently set, including internals. */
+    labels: Record<string, string>;
+};
+export type ParallelstoreInstance = Resource<"GCP.ParallelstoreInstance", ParallelstoreInstanceProps, ParallelstoreInstanceAttributes, never, GCP.Providers>;
+export declare const ParallelstoreInstance: import("alchemy").ResourceClass<ParallelstoreInstance>;
+export declare const ParallelstoreInstanceProvider: () => import("effect/Layer").Layer<Provider.Provider<ParallelstoreInstance>, never, import("effect/unstable/http/HttpClient").HttpClient | import("alchemy").Stage | import("alchemy").Stack | import("@distilled.cloud/gcp").Credentials>;
+//# sourceMappingURL=Instance.d.ts.map

package/lib/Parallelstore/Instance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Instance.d.ts","sourceRoot":"","sources":["../../src/Parallelstore/Instance.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAKnC,OAAO,KAAK,QAAQ,MAAM,kBAAkB,CAAC;AAK7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,KAAK,KAAK,GAAG,MAAM,iBAAiB,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,2EAA2E;IAC3E,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,OAAO,EAAE,UAAU,CAAC;IACpB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gEAAgE;IAChE,cAAc,CAAC,EAAE,SAAS,GAAG,YAAY,CAAC;IAC1C,uCAAuC;IACvC,eAAe,CAAC,EACZ,uBAAuB,GACvB,4BAA4B,GAC5B,uBAAuB,CAAC;IAC5B,4CAA4C;IAC5C,oBAAoB,CAAC,EACjB,4BAA4B,GAC5B,iCAAiC,GACjC,4BAA4B,CAAC;IACjC;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG;IAC5C,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,uBAAuB;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,OAAO,EAAE,UAAU,CAAC;IACpB,gDAAgD;IAChD,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,kDAAkD;IAClD,wBAAwB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7C,6CAA6C;IAC7C,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,8BAA8B;IAC9B,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,uCAAuC;IACvC,YAAY,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACpC,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAC1C,2BAA2B,EAC3B,0BAA0B,EAC1B,+BAA+B,EAC/B,KAAK,EACL,GAAG,CAAC,SAAS,CACd,CAAC;AACF,eAAO,MAAM,qBAAqB,wDAEjC,CAAC;AA+BF,eAAO,MAAM,6BAA6B,4OAmMvC,CAAC"}

package/lib/Parallelstore/Instance.js

@@ -0,0 +1,180 @@
+import { ConfigError } from "@distilled.cloud/gcp";
+import * as ps from "@distilled.cloud/gcp/parallelstore-v1";
+import { Resource } from "alchemy";
+import { Unowned } from "alchemy/AdoptPolicy";
+import { isResolved, somePropsAreDifferent } from "alchemy/Diff";
+import { createPhysicalName } from "alchemy/PhysicalName";
+import * as Provider from "alchemy/Provider";
+import { diffTags } from "alchemy/Tags";
+import * as Duration from "effect/Duration";
+import * as Effect from "effect/Effect";
+import * as Schedule from "effect/Schedule";
+import { gcpInternalLabels, hasAlchemyLabels } from "../Tags.js";
+export const ParallelstoreInstance = Resource("GCP.ParallelstoreInstance");
+const toAttributes = (i, parent) => ({
+    instanceId: parent.instanceId,
+    project: parent.project,
+    location: parent.location,
+    name: i.name ?? `projects/${parent.project}/locations/${parent.location}/instances/${parent.instanceId}`,
+    description: i.description,
+    capacityGib: i.capacityGib ?? "",
+    // The server-echoed `i.network` matches what we sent up at create
+    // time, but we thread `parent.network` through to preserve the
+    // `NetworkRef` type without a cast — same pattern as project /
+    // location, both of which would otherwise lose their typing through
+    // the SDK's `string | undefined` fields.
+    network: parent.network,
+    reservedIpRange: i.reservedIpRange,
+    effectiveReservedIpRange: i.effectiveReservedIpRange,
+    state: i.state,
+    deploymentType: i.deploymentType,
+    accessPoints: i.accessPoints ?? [],
+    labels: { ...(i.labels ?? {}) },
+});
+export const ParallelstoreInstanceProvider = () => Provider.effect(ParallelstoreInstance, Effect.gen(function* () {
+    const getInstance = yield* ps.getProjectsLocationsInstances;
+    const createInstance = yield* ps.createProjectsLocationsInstances;
+    const patchInstance = yield* ps.patchProjectsLocationsInstances;
+    const deleteInstance = yield* ps.deleteProjectsLocationsInstances;
+    const getOperation = yield* ps.getProjectsLocationsOperations;
+    const awaitOperation = Effect.fn(function* (operationName, session) {
+        const op = yield* getOperation({ name: operationName }).pipe(Effect.flatMap((current) => current.done === true
+            ? Effect.succeed(current)
+            : Effect.fail({ _tag: "OperationPending" })), Effect.retry({
+            while: (e) => e?._tag === "OperationPending",
+            schedule: Schedule.exponential(Duration.seconds(5), 1.5).pipe(Schedule.either(Schedule.spaced(Duration.seconds(30))), 
+            // Parallelstore creates routinely run 10–25 min for
+            // multi-TiB instances. 200 × 30s ≈ 100 min wall ceiling.
+            Schedule.both(Schedule.recurs(200)), Schedule.tapOutput(() => session.note(`Waiting for Parallelstore operation ${operationName}…`))),
+        }));
+        if (op.error) {
+            return yield* new ConfigError({
+                message: `Parallelstore operation ${operationName} failed: ${op.error.message ?? JSON.stringify(op.error)}`,
+            });
+        }
+        return op;
+    });
+    const fqName = (project, location, instanceId) => `projects/${project}/locations/${location}/instances/${instanceId}`;
+    const observe = (project, location, instanceId) => getInstance({ name: fqName(project, location, instanceId) }).pipe(Effect.catchTag("NotFound", () => Effect.succeed(undefined)), Effect.catchTag("Forbidden", () => Effect.succeed(undefined)));
+    const syncMutable = Effect.fn(function* (args) {
+        const updateMaskFields = [];
+        if ((args.observed.description ?? undefined) !== args.desired.description) {
+            updateMaskFields.push("description");
+        }
+        const observedLabels = { ...(args.observed.labels ?? {}) };
+        const labelDiff = diffTags(observedLabels, args.desired.labels);
+        if (labelDiff.removed.length > 0 || labelDiff.upsert.length > 0) {
+            updateMaskFields.push("labels");
+        }
+        if (updateMaskFields.length === 0)
+            return;
+        const op = yield* patchInstance({
+            name: args.name,
+            updateMask: updateMaskFields.join(","),
+            body: {
+                description: args.desired.description,
+                labels: args.desired.labels,
+            },
+        });
+        if (op.name)
+            yield* awaitOperation(op.name, args.session);
+    });
+    return {
+        stables: ["instanceId", "project", "location", "name"],
+        diff: Effect.fn(function* ({ news, olds = {} }) {
+            if (!isResolved(news))
+                return undefined;
+            if (somePropsAreDifferent(olds, news, [
+                "project",
+                "location",
+                "instanceId",
+                "network",
+                "reservedIpRange",
+                "deploymentType",
+                "fileStripeLevel",
+                "directoryStripeLevel",
+                "capacityGib",
+            ])) {
+                return { action: "replace" };
+            }
+            return undefined;
+        }),
+        reconcile: Effect.fn(function* ({ id, news, session }) {
+            const internalLabels = yield* gcpInternalLabels(id);
+            const desiredId = news.instanceId ??
+                (yield* createPhysicalName({ id, maxLength: 63 })).toLowerCase();
+            const parent = `projects/${news.project}/locations/${news.location}`;
+            const name = fqName(news.project, news.location, desiredId);
+            const desiredLabels = {
+                ...(news.labels ?? {}),
+                ...internalLabels,
+            };
+            let observed = yield* observe(news.project, news.location, desiredId);
+            if (!observed) {
+                const body = {
+                    capacityGib: news.capacityGib,
+                    network: news.network,
+                    ...(news.description ? { description: news.description } : {}),
+                    ...(news.reservedIpRange ? { reservedIpRange: news.reservedIpRange } : {}),
+                    ...(news.deploymentType ? { deploymentType: news.deploymentType } : {}),
+                    ...(news.fileStripeLevel ? { fileStripeLevel: news.fileStripeLevel } : {}),
+                    ...(news.directoryStripeLevel
+                        ? { directoryStripeLevel: news.directoryStripeLevel }
+                        : {}),
+                    labels: desiredLabels,
+                };
+                const op = yield* createInstance({
+                    parent,
+                    instanceId: desiredId,
+                    body,
+                }).pipe(Effect.catchTag("Conflict", () => Effect.succeed(undefined)));
+                if (op?.name)
+                    yield* awaitOperation(op.name, session);
+                observed = yield* getInstance({ name });
+            }
+            yield* syncMutable({
+                name,
+                observed,
+                desired: { description: news.description, labels: desiredLabels },
+                session,
+            });
+            const final = yield* getInstance({ name });
+            return toAttributes(final, {
+                project: news.project,
+                location: news.location,
+                instanceId: desiredId,
+                network: news.network,
+            });
+        }),
+        delete: Effect.fn(function* ({ output, session }) {
+            yield* deleteInstance({ name: output.name }).pipe(Effect.flatMap((op) => op.name ? awaitOperation(op.name, session) : Effect.succeed(op)), Effect.catchTag("NotFound", () => Effect.void));
+        }),
+        read: Effect.fn(function* ({ id, output, olds }) {
+            const project = output?.project ?? olds?.project;
+            const location = output?.location ?? olds?.location;
+            // `network` only narrows to NetworkRef when it comes from
+            // post-create `output`. `olds` is the snapshot of *props*
+            // including a NetworkRef, so both feed into the same typed
+            // pipeline.
+            const network = output?.network ?? olds?.network;
+            if (!project || !location || !network)
+                return undefined;
+            const instanceId = output?.instanceId ??
+                olds?.instanceId ??
+                (yield* createPhysicalName({ id, maxLength: 63 })).toLowerCase();
+            const observed = yield* observe(project, location, instanceId);
+            if (!observed)
+                return undefined;
+            const attrs = toAttributes(observed, {
+                project,
+                location,
+                instanceId,
+                network,
+            });
+            return (yield* hasAlchemyLabels(id, observed.labels))
+                ? attrs
+                : Unowned(attrs);
+        }),
+    };
+}));
+//# sourceMappingURL=Instance.js.map

package/lib/Parallelstore/Instance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Instance.js","sourceRoot":"","sources":["../../src/Parallelstore/Instance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EAAE,MAAM,uCAAuC,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE9C,OAAO,EAAa,UAAU,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,QAAQ,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAiIjE,MAAM,CAAC,MAAM,qBAAqB,GAAG,QAAQ,CAC3C,2BAA2B,CAC5B,CAAC;AAEF,MAAM,YAAY,GAAG,CACnB,CAAc,EACd,MAKC,EACgC,EAAE,CAAC,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC,UAAU;IAC7B,OAAO,EAAE,MAAM,CAAC,OAAO;IACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;IACzB,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,YAAY,MAAM,CAAC,OAAO,cAAc,MAAM,CAAC,QAAQ,cAAc,MAAM,CAAC,UAAU,EAAE;IACxG,WAAW,EAAE,CAAC,CAAC,WAAW;IAC1B,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,EAAE;IAChC,kEAAkE;IAClE,+DAA+D;IAC/D,+DAA+D;IAC/D,oEAAoE;IACpE,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC,OAAO;IACvB,eAAe,EAAE,CAAC,CAAC,eAAe;IAClC,wBAAwB,EAAE,CAAC,CAAC,wBAAwB;IACpD,KAAK,EAAE,CAAC,CAAC,KAAK;IACd,cAAc,EAAE,CAAC,CAAC,cAAc;IAChC,YAAY,EAAE,CAAC,CAAC,YAAY,IAAI,EAAE;IAClC,MAAM,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE;CAChC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,6BAA6B,GAAG,GAAG,EAAE,CAChD,QAAQ,CAAC,MAAM,CACb,qBAAqB,EACrB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,6BAA6B,CAAC;IAC5D,MAAM,cAAc,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,gCAAgC,CAAC;IAClE,MAAM,aAAa,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,+BAA+B,CAAC;IAChE,MAAM,cAAc,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,gCAAgC,CAAC;IAClE,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,8BAA8B,CAAC;IAE9D,MAAM,cAAc,GAAG,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,EACxC,aAAqB,EACrB,OAAgC;QAEhC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC,IAAI,CAC1D,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CACzB,OAAO,CAAC,IAAI,KAAK,IAAI;YACnB,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;YACzB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,kBAA2B,EAAE,CAAC,CACvD,EACD,MAAM,CAAC,KAAK,CAAC;YACX,KAAK,EAAE,CAAC,CAAoB,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,KAAK,kBAAkB;YAC/D,QAAQ,EAAE,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAC3D,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;YACtD,oDAAoD;YACpD,yDAAyD;YACzD,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EACnC,QAAQ,CAAC,SAAS,CAAC,GAAG,EAAE,CACtB,OAAO,CAAC,IAAI,CAAC,uCAAuC,aAAa,GAAG,CAAC,CACtE,CACF;SACF,CAAC,CACH,CAAC;QACF,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC;YACb,OAAO,KAAK,CAAC,CAAC,IAAI,WAAW,CAAC;gBAC5B,OAAO,EAAE,2BAA2B,aAAa,YAC/C,EAAE,CAAC,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,CAC7C,EAAE;aACH,CAAC,CAAC;QACL,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,CAAC,OAAe,EAAE,QAAgB,EAAE,UAAkB,EAAE,EAAE,CACvE,YAAY,OAAO,cAAc,QAAQ,cAAc,UAAU,EAAE,CAAC;IAEtE,MAAM,OAAO,GAAG,CAAC,OAAe,EAAE,QAAgB,EAAE,UAAkB,EAAE,EAAE,CACxE,WAAW,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC,IAAI,CAC/D,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE,CAC/B,MAAM,CAAC,OAAO,CAAC,SAAoC,CAAC,CACrD,EACD,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE,CAChC,MAAM,CAAC,OAAO,CAAC,SAAoC,CAAC,CACrD,CACF,CAAC;IAEJ,MAAM,WAAW,GAAG,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,IAKxC;QACC,MAAM,gBAAgB,GAAa,EAAE,CAAC;QACtC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,IAAI,SAAS,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YAC1E,gBAAgB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACvC,CAAC;QACD,MAAM,cAAc,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC;QAC3D,MAAM,SAAS,GAAG,QAAQ,CAAC,cAAc,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAChE,IAAI,SAAS,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,SAAS,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChE,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAClC,CAAC;QACD,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAE1C,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,aAAa,CAAC;YAC9B,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,UAAU,EAAE,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC;YACtC,IAAI,EAAE;gBACJ,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW;gBACrC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM;aAC5B;SACF,CAAC,CAAC;QACH,IAAI,EAAE,CAAC,IAAI;YAAE,KAAK,CAAC,CAAC,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,OAAO,EAAE,CAAC,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,CAAC;QACtD,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,GAAG,EAAE,EAAE;YAC5C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;gBAAE,OAAO,SAAS,CAAC;YACxC,IACE,qBAAqB,CAAC,IAAkC,EAAE,IAAI,EAAE;gBAC9D,SAAS;gBACT,UAAU;gBACV,YAAY;gBACZ,SAAS;gBACT,iBAAiB;gBACjB,gBAAgB;gBAChB,iBAAiB;gBACjB,sBAAsB;gBACtB,aAAa;aACd,CAAC,EACF,CAAC;gBACD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAW,CAAC;YACxC,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC,CAAC;QACF,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;YACnD,MAAM,cAAc,GAAG,KAAK,CAAC,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;YACpD,MAAM,SAAS,GACb,IAAI,CAAC,UAAU;gBACf,CAAC,KAAK,CAAC,CAAC,kBAAkB,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;YACnE,MAAM,MAAM,GAAG,YAAY,IAAI,CAAC,OAAO,cAAc,IAAI,CAAC,QAAQ,EAAE,CAAC;YACrE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YAC5D,MAAM,aAAa,GAA2B;gBAC5C,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC;gBACtB,GAAG,cAAc;aAClB,CAAC;YAEF,IAAI,QAAQ,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YAEtE,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,GAAgB;oBACxB,WAAW,EAAE,IAAI,CAAC,WAAW;oBAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;oBACrB,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC9D,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC1E,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACvE,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC1E,GAAG,CAAC,IAAI,CAAC,oBAAoB;wBAC3B,CAAC,CAAC,EAAE,oBAAoB,EAAE,IAAI,CAAC,oBAAoB,EAAE;wBACrD,CAAC,CAAC,EAAE,CAAC;oBACP,MAAM,EAAE,aAAa;iBACtB,CAAC;gBACF,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,cAAc,CAAC;oBAC/B,MAAM;oBACN,UAAU,EAAE,SAAS;oBACrB,IAAI;iBACL,CAAC,CAAC,IAAI,CACL,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE,CAC/B,MAAM,CAAC,OAAO,CAAC,SAAqC,CAAC,CACtD,CACF,CAAC;gBACF,IAAI,EAAE,EAAE,IAAI;oBAAE,KAAK,CAAC,CAAC,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;gBACtD,QAAQ,GAAG,KAAK,CAAC,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;YAC1C,CAAC;YAED,KAAK,CAAC,CAAC,WAAW,CAAC;gBACjB,IAAI;gBACJ,QAAQ;gBACR,OAAO,EAAE,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE;gBACjE,OAAO;aACR,CAAC,CAAC;YAEH,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;YAC3C,OAAO,YAAY,CAAC,KAAK,EAAE;gBACzB,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,UAAU,EAAE,SAAS;gBACrB,OAAO,EAAE,IAAI,CAAC,OAAO;aACtB,CAAC,CAAC;QACL,CAAC,CAAC;QACF,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE;YAC9C,KAAK,CAAC,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAC/C,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CACpB,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAChE,EACD,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAC/C,CAAC;QACJ,CAAC,CAAC;QACF,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;YAC7C,MAAM,OAAO,GAAG,MAAM,EAAE,OAAO,IAAI,IAAI,EAAE,OAAO,CAAC;YACjD,MAAM,QAAQ,GAAG,MAAM,EAAE,QAAQ,IAAI,IAAI,EAAE,QAAQ,CAAC;YACpD,0DAA0D;YAC1D,0DAA0D;YAC1D,2DAA2D;YAC3D,YAAY;YACZ,MAAM,OAAO,GAAG,MAAM,EAAE,OAAO,IAAI,IAAI,EAAE,OAAO,CAAC;YACjD,IAAI,CAAC,OAAO,IAAI,CAAC,QAAQ,IAAI,CAAC,OAAO;gBAAE,OAAO,SAAS,CAAC;YACxD,MAAM,UAAU,GACd,MAAM,EAAE,UAAU;gBAClB,IAAI,EAAE,UAAU;gBAChB,CAAC,KAAK,CAAC,CAAC,kBAAkB,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;YACnE,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;YAC/D,IAAI,CAAC,QAAQ;gBAAE,OAAO,SAAS,CAAC;YAChC,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,EAAE;gBACnC,OAAO;gBACP,QAAQ;gBACR,UAAU;gBACV,OAAO;aACR,CAAC,CAAC;YACH,OAAO,CAAC,KAAK,CAAC,CAAC,gBAAgB,CAAC,EAAE,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;gBACnD,CAAC,CAAC,KAAK;gBACP,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC,CAAC;KACH,CAAC;AACJ,CAAC,CAAC,CACH,CAAC"}

package/lib/Parallelstore/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./Instance.ts";
+//# sourceMappingURL=index.d.ts.map

package/lib/Parallelstore/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Parallelstore/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}

package/lib/Parallelstore/index.js

@@ -0,0 +1,2 @@
+export * from "./Instance.js";
+//# sourceMappingURL=index.js.map

package/lib/Parallelstore/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/Parallelstore/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}

package/lib/Providers.d.ts

@@ -0,0 +1,24 @@
+import * as Provider from "alchemy/Provider";
+import * as Layer from "effect/Layer";
+declare const Providers_base: Provider.ProviderCollection<Providers, "GCP">;
+export declare class Providers extends Providers_base {
+}
+export type ProviderRequirements = Layer.Services<ReturnType<typeof providers>>;
+/**
+ * Bundle the GCP resource providers, AuthProvider-backed credentials, and an
+ * HTTP client into a single Layer suitable for `Alchemy.Stack({ providers })`.
+ *
+ * Credentials resolve through the Alchemy AuthProvider registry — the active
+ * profile (from `ALCHEMY_PROFILE`, default `"default"`) configures `project`
+ * and optional `keyFile` overrides; everything else (ADC discovery, env-var
+ * key files, metadata server) is delegated to `google-auth-library`. To
+ * bypass the registry, import {@link fromADC} directly.
+ *
+ * `FetchHttpClient.layer` is provided once at the Stack level (see
+ * `vendor/alchemy/packages/alchemy/src/Stack.ts`); we intentionally do NOT
+ * re-provide it here, mirroring `AWS/Providers.ts` and
+ * `Cloudflare/Providers.ts`.
+ */
+export declare const providers: () => Layer.Layer<import("@distilled.cloud/gcp").Credentials | Providers, never, import("effect/FileSystem").FileSystem | import("effect/unstable/http/HttpClient").HttpClient | import("alchemy").AuthProviders | import("alchemy").Stage | import("alchemy").Stack>;
+export {};
+//# sourceMappingURL=Providers.d.ts.map

package/lib/Providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Providers.d.ts","sourceRoot":"","sources":["../src/Providers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;;AAwBtC,qBAAa,SAAU,SAAQ,cAA+C;CAAG;AAEjF,MAAM,MAAM,oBAAoB,GAAG,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC,CAAC;AAEhF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,SAAS,uQAuCnB,CAAC"}

package/lib/Providers.js

@@ -0,0 +1,51 @@
+import * as Provider from "alchemy/Provider";
+import * as Layer from "effect/Layer";
+import { GCPAuth } from "./Auth/AuthProvider.js";
+import { fromAuthProvider } from "./Auth/Credentials.js";
+import { Project, ProjectProvider } from "./CloudResourceManager/Project.js";
+import { GlobalAddress, GlobalAddressProvider } from "./Compute/GlobalAddress.js";
+import { Network, NetworkProvider } from "./Compute/Network.js";
+import { SharedVpcHost, SharedVpcHostProvider } from "./Compute/SharedVpcHost.js";
+import { SharedVpcServiceProject, SharedVpcServiceProjectProvider, } from "./Compute/SharedVpcServiceProject.js";
+import { Subnetwork, SubnetworkProvider } from "./Compute/Subnetwork.js";
+import { Cluster, ClusterProvider } from "./Container/Cluster.js";
+import { NodePool, NodePoolProvider } from "./Container/NodePool.js";
+import { ParallelstoreInstance, ParallelstoreInstanceProvider, } from "./Parallelstore/Instance.js";
+import { PsaConnection, PsaConnectionProvider, } from "./ServiceNetworking/PsaConnection.js";
+import { ApiEnable, ApiEnableProvider } from "./ServiceUsage/ApiEnable.js";
+export class Providers extends Provider.ProviderCollection()("GCP") {
+}
+/**
+ * Bundle the GCP resource providers, AuthProvider-backed credentials, and an
+ * HTTP client into a single Layer suitable for `Alchemy.Stack({ providers })`.
+ *
+ * Credentials resolve through the Alchemy AuthProvider registry — the active
+ * profile (from `ALCHEMY_PROFILE`, default `"default"`) configures `project`
+ * and optional `keyFile` overrides; everything else (ADC discovery, env-var
+ * key files, metadata server) is delegated to `google-auth-library`. To
+ * bypass the registry, import {@link fromADC} directly.
+ *
+ * `FetchHttpClient.layer` is provided once at the Stack level (see
+ * `vendor/alchemy/packages/alchemy/src/Stack.ts`); we intentionally do NOT
+ * re-provide it here, mirroring `AWS/Providers.ts` and
+ * `Cloudflare/Providers.ts`.
+ */
+export const providers = () => Layer.effect(Providers, Provider.collection([
+    Project,
+    Cluster,
+    NodePool,
+    ApiEnable,
+    Network,
+    Subnetwork,
+    GlobalAddress,
+    SharedVpcHost,
+    SharedVpcServiceProject,
+    PsaConnection,
+    ParallelstoreInstance,
+])).pipe(Layer.provide(Layer.mergeAll(ProjectProvider(), ClusterProvider(), NodePoolProvider(), ApiEnableProvider(), NetworkProvider(), SubnetworkProvider(), GlobalAddressProvider(), SharedVpcHostProvider(), SharedVpcServiceProjectProvider(), PsaConnectionProvider(), ParallelstoreInstanceProvider())), Layer.provideMerge(fromAuthProvider()), Layer.provideMerge(GCPAuth), 
+// Auth/config failures (missing ADC, malformed profile) become
+// unrecoverable defects rather than typed errors — mirrors
+// `AWS/Providers.ts` and `Cloudflare/Providers.ts`. Resource lifecycle
+// handlers still surface their own typed errors normally.
+Layer.orDie);
+//# sourceMappingURL=Providers.js.map

package/lib/Providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Providers.js","sourceRoot":"","sources":["../src/Providers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAClF,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAClF,OAAO,EACL,uBAAuB,EACvB,+BAA+B,GAChC,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EACL,qBAAqB,EACrB,6BAA6B,GAC9B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,aAAa,EACb,qBAAqB,GACtB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAE3E,MAAM,OAAO,SAAU,SAAQ,QAAQ,CAAC,kBAAkB,EAAa,CAAC,KAAK,CAAC;CAAG;AAIjF;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,EAAE,CAC5B,KAAK,CAAC,MAAM,CACV,SAAS,EACT,QAAQ,CAAC,UAAU,CAAC;IAClB,OAAO;IACP,OAAO;IACP,QAAQ;IACR,SAAS;IACT,OAAO;IACP,UAAU;IACV,aAAa;IACb,aAAa;IACb,uBAAuB;IACvB,aAAa;IACb,qBAAqB;CACtB,CAAC,CACH,CAAC,IAAI,CACJ,KAAK,CAAC,OAAO,CACX,KAAK,CAAC,QAAQ,CACZ,eAAe,EAAE,EACjB,eAAe,EAAE,EACjB,gBAAgB,EAAE,EAClB,iBAAiB,EAAE,EACnB,eAAe,EAAE,EACjB,kBAAkB,EAAE,EACpB,qBAAqB,EAAE,EACvB,qBAAqB,EAAE,EACvB,+BAA+B,EAAE,EACjC,qBAAqB,EAAE,EACvB,6BAA6B,EAAE,CAChC,CACF,EACD,KAAK,CAAC,YAAY,CAAC,gBAAgB,EAAE,CAAC,EACtC,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC;AAC3B,+DAA+D;AAC/D,2DAA2D;AAC3D,uEAAuE;AACvE,0DAA0D;AAC1D,KAAK,CAAC,KAAK,CACZ,CAAC"}

package/lib/ServiceNetworking/PsaConnection.d.ts

@@ -0,0 +1,84 @@
+import { Resource } from "alchemy";
+import * as Provider from "alchemy/Provider";
+import type { NetworkRef } from "../Compute/Network.ts";
+import type * as GCP from "../Providers.ts";
+/**
+ * A **Private Services Access (PSA)** connection that peers a Google
+ * service-producer VPC into the consumer VPC, drawing from one or more
+ * pre-allocated `GCP.GlobalAddress` ranges.
+ *
+ * Identity: `(network, service)`. There can only be one PSA connection
+ * per `(VPC, service)` pair, so the resource is keyed by both. The
+ * peering name (used in delete/patch URLs) is server-assigned —
+ * canonically `servicenetworking-googleapis-com` for the standard
+ * Service Networking peering — and is read off the live connection
+ * rather than reconstructed.
+ *
+ * Service Networking operations use a CRM-style `Operation.done:
+ * boolean`, not the compute `.status: "DONE"` shape, so this resource
+ * uses its own polling helper rather than the Compute one.
+ *
+ * @section Setting up PSA for Parallelstore
+ * @example
+ * ```typescript
+ * // Reserve the range first.
+ * const psaRange = yield* GCP.GlobalAddress("PsaRange", {
+ *   project: hostProject.projectId,
+ *   network: vpc.selfLink,
+ *   purpose: "VPC_PEERING",
+ *   addressType: "INTERNAL",
+ *   prefixLength: 20,
+ * });
+ *
+ * // Then peer. `networkRef` enforces the project-number form at the
+ * // type level — `Project.projectNumber` is typed as `${number}` so
+ * // this composes without manual casts.
+ * yield* GCP.PsaConnection("Psa", {
+ *   network: GCP.networkRef(hostProject.projectNumber, vpc.name),
+ *   reservedPeeringRanges: [psaRange.name],
+ * });
+ * ```
+ *
+ * The `network` field is typed as `NetworkRef` —
+ * `projects/{projectNumber}/global/networks/{name}` — because the
+ * service producer's backend resolves peerings against the numeric
+ * project id, not the project id string. Use `networkRef` to build
+ * the value; passing a project ID will fail to typecheck.
+ */
+export type PsaConnectionProps = {
+    /**
+     * Fully-qualified consumer VPC in project-number form. Build with
+     * `networkRef(project.projectNumber, vpc.name)` from `Compute/Network.ts`
+     * — that helper composes the right shape and the type system rejects
+     * passing a project ID. Immutable — replace.
+     */
+    network: NetworkRef;
+    /**
+     * Service Networking service. Defaults to `servicenetworking.googleapis.com`
+     * (the only producer that PSA-aware GCP services like Parallelstore,
+     * Cloud SQL, Memorystore peer through).
+     */
+    service?: string;
+    /**
+     * Names of `GCP.GlobalAddress` ranges (with `purpose=VPC_PEERING`) to
+     * cede to the service producer. Mutable via `patchServicesConnections`.
+     * Removing a range previously assigned requires `force=true` server-
+     * side; this provider always passes `force=true` on patch to honour
+     * the user's declared shape.
+     */
+    reservedPeeringRanges: ReadonlyArray<string>;
+};
+export type PsaConnectionAttributes = {
+    /** Consumer VPC URL, threaded through from props. */
+    network: NetworkRef;
+    /** `services/<service>` resource name, threaded through from props. */
+    serviceName: string;
+    /** Server-assigned peering name (e.g. `servicenetworking-googleapis-com`). */
+    peering: string;
+    /** Reserved peering ranges currently in use. */
+    reservedPeeringRanges: ReadonlyArray<string>;
+};
+export type PsaConnection = Resource<"GCP.PsaConnection", PsaConnectionProps, PsaConnectionAttributes, never, GCP.Providers>;
+export declare const PsaConnection: import("alchemy").ResourceClass<PsaConnection>;
+export declare const PsaConnectionProvider: () => import("effect/Layer").Layer<Provider.Provider<PsaConnection>, never, import("effect/unstable/http/HttpClient").HttpClient | import("@distilled.cloud/gcp").Credentials>;
+//# sourceMappingURL=PsaConnection.d.ts.map

package/lib/ServiceNetworking/PsaConnection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PsaConnection.d.ts","sourceRoot":"","sources":["../../src/ServiceNetworking/PsaConnection.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGnC,OAAO,KAAK,QAAQ,MAAM,kBAAkB,CAAC;AAI7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,KAAK,GAAG,MAAM,iBAAiB,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;;;;OAKG;IACH,OAAO,EAAE,UAAU,CAAC;IACpB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,qBAAqB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC9C,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,qDAAqD;IACrD,OAAO,EAAE,UAAU,CAAC;IACpB,uEAAuE;IACvE,WAAW,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,qBAAqB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC9C,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,QAAQ,CAClC,mBAAmB,EACnB,kBAAkB,EAClB,uBAAuB,EACvB,KAAK,EACL,GAAG,CAAC,SAAS,CACd,CAAC;AACF,eAAO,MAAM,aAAa,gDAA+C,CAAC;AAO1E,eAAO,MAAM,qBAAqB,gLAoK/B,CAAC"}