@prisma/composer-cli 0.30.0 → 0.31.0-dev.2

package/dist/execute-dev-current-mKLK92xq-cCet5L57.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-dev-current-mKLK92xq-cCet5L57.mjs","names":[],"sources":["../../../0-framework/3-tooling/cli/dist/execute-dev-current-mKLK92xq.mjs"],"sourcesContent":["import { l as toStructured } from \"./dev-current-BLBLXm8k.mjs\";\nimport { t as checkConfigSource } from \"./pipeline-Dpesfd2j.mjs\";\nimport { notOk, ok } from \"@internal/foundation/result\";\nimport { CliStructuredError, InternalError } from \"@internal/foundation/errors\";\nimport * as path from \"node:path\";\nimport { DEV_DIR, resolveLocalTargets } from \"@internal/core/local-target\";\n//#region src/operations/execute-dev-current.ts\n/**\n* The `devUrl` and `devStop` executor: config → each extension's local\n* target → the app it recorded in the directory's dev state. Reached only by\n* lazy import from dev-current.ts — resolving the local targets loads their\n* descriptors, whose graphs reach alchemy's provider tree.\n*/\nconst RUN_DEV = \"Run `prisma dev <entry>` in this directory.\";\nfunction platformUnsupported() {\n\treturn new CliStructuredError(\"DEV.PLATFORM_UNSUPPORTED\", \"local dev is not supported on Windows yet.\");\n}\n/** A call into an extension's local target; its failures that carry no code are the emulator's. */\nasync function fromTarget(call) {\n\ttry {\n\t\treturn await call();\n\t} catch (error) {\n\t\tthrow toStructured(\"DEV.EMULATOR_FAILED\", error);\n\t}\n}\n/** Every extension's record of the app `prisma dev` last ran from `cwd`; fails when none recorded one. */\nasync function currentApps(input, cwd) {\n\tconst { value } = checkConfigSource(input.config, cwd);\n\tconst devDir = path.join(cwd, DEV_DIR);\n\tconst apps = [];\n\tfor (const target of (await resolveLocalTargets(value)).values()) {\n\t\tconst current = await fromTarget(async () => target.current?.({ devDir }));\n\t\tif (current !== void 0) apps.push(current);\n\t}\n\tif (apps.length === 0) throw new CliStructuredError(\"DEV.NOT_STARTED_HERE\", `\\`prisma dev\\` has not run in ${cwd}.`, {\n\t\twhy: `The local services, databases and buckets of an app are recorded in ${devDir} when \\`prisma dev\\` runs there, and there is no such record.`,\n\t\tfix: RUN_DEV,\n\t\tmeta: { cwd }\n\t});\n\treturn apps;\n}\nasync function locate(input, cwd) {\n\tconst apps = await currentApps(input, cwd);\n\tconst app = apps.find((candidate) => candidate.addresses.includes(input.address));\n\tif (app === void 0) {\n\t\tconst known = apps.flatMap((candidate) => candidate.addresses).sort();\n\t\tthrow new CliStructuredError(\"DEV.ADDRESS_UNKNOWN\", `\"${apps.map((a) => a.app).join(\"\\\", \\\"\")}\" has no node at \"${input.address}\".`, {\n\t\t\twhy: `The addresses recorded for the app \\`prisma dev\\` last ran here are: ${known.join(\", \")}.`,\n\t\t\tfix: \"Pass one of those addresses. A nested node has a dotted address, such as `catalog.database`.\",\n\t\t\tmeta: {\n\t\t\t\taddress: input.address,\n\t\t\t\tknown\n\t\t\t}\n\t\t});\n\t}\n\tconst location = await fromTarget(() => app.locate(input.address));\n\tif (location === void 0) throw new InternalError(`the local target recorded \"${input.address}\" but cannot locate it`);\n\tif (location.emulator === \"not-running\") throw new CliStructuredError(\"DEV.EMULATOR_UNREACHABLE\", `The local ${location.kind} emulator that runs \"${input.address}\" is not running.`, {\n\t\twhy: \"The local emulators run your services, databases and buckets on this machine; `prisma dev` starts the ones an app needs.\",\n\t\tfix: RUN_DEV,\n\t\tmeta: {\n\t\t\taddress: input.address,\n\t\t\tkind: location.kind\n\t\t}\n\t});\n\tif (location.condition !== \"running\") throw notRunning(input.address, location);\n\tif (location.url === void 0) throw new InternalError(`the local target reports \"${input.address}\" running with no URL`);\n\treturn {\n\t\taddress: input.address,\n\t\tkind: location.kind,\n\t\turl: location.url,\n\t\tstate: location.state\n\t};\n}\nfunction notRunning(address, location) {\n\tconst { kind, state, condition, logPath } = location;\n\tconst meta = {\n\t\taddress,\n\t\tkind,\n\t\tstate,\n\t\t...logPath === void 0 ? {} : { logPath }\n\t};\n\tconst message = `The ${kind} \"${address}\" is not running (${state}).`;\n\tif (condition === \"crashing\") return new CliStructuredError(\"DEV.NOT_RUNNING\", message, {\n\t\twhy: \"It exited after it started, and it is being restarted or was held after repeated crashes.\",\n\t\tfix: logPath === void 0 ? \"Read its output in the `prisma dev` terminal, fix the cause, and rebuild.\" : `Read its log at ${logPath}, fix the cause, and rebuild.`,\n\t\tmeta\n\t});\n\tif (condition === \"missing\") return new CliStructuredError(\"DEV.NOT_RUNNING\", message, {\n\t\twhy: \"The local emulator no longer has it, for example because a Composer upgrade discarded the emulator’s state.\",\n\t\tfix: `${RUN_DEV} It creates the ${kind} again, empty.`,\n\t\tmeta\n\t});\n\treturn new CliStructuredError(\"DEV.NOT_RUNNING\", `The ${kind} \"${address}\" is stopped.`, {\n\t\twhy: \"`prisma dev stop`, `prisma dev` ending, and running another app in this directory all stop an app's services and database servers, and a stopped node has no URL that answers.\",\n\t\tfix: RUN_DEV,\n\t\tmeta\n\t});\n}\nasync function executeDevUrl(input, cwd) {\n\tif (process.platform === \"win32\") return notOk(platformUnsupported());\n\ttry {\n\t\treturn ok(await locate(input, cwd));\n\t} catch (error) {\n\t\tif (CliStructuredError.is(error)) return notOk(error);\n\t\tthrow error;\n\t}\n}\nasync function executeDevStop(input, cwd) {\n\tif (process.platform === \"win32\") return notOk(platformUnsupported());\n\ttry {\n\t\tconst apps = await currentApps(input, cwd);\n\t\tconst stopped = [];\n\t\tfor (const app of apps) stopped.push(...await fromTarget(() => app.stop()));\n\t\treturn ok({\n\t\t\tapp: apps.map((a) => a.app).join(\", \"),\n\t\t\tstopped\n\t\t});\n\t} catch (error) {\n\t\tif (CliStructuredError.is(error)) return notOk(error);\n\t\tthrow error;\n\t}\n}\n//#endregion\nexport { executeDevStop, executeDevUrl };\n\n//# sourceMappingURL=execute-dev-current-mKLK92xq.mjs.map"],"mappings":"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"}

package/dist/{family-Dt7BgpVf-YyjGLli3.d.mts → family-BIyR33Uq-BEqJM2Vx.d.mts}

@@ -158,7 +158,27 @@ declare namespace StandardSchemaV1 {
   type InferOutput<Schema extends StandardTypedV1> = StandardTypedV1.InferOutput<Schema>;
 }
 //#endregion
-//#region ../../0-framework/1-core/core/dist/graph-types-BTTaRnih.d.mts
+//#region ../../0-framework/1-core/core/dist/graph-types-Cegbwb_X.d.mts
+//#region src/contract.d.ts
+/**
+ * A Contract is the declared interface of a service-to-service dependency: a
+ * protocol brand (`kind`) plus an opaque comparison type (`Cmp`) the core
+ * never inspects. Wiring compatibility is plain TypeScript assignability on
+ * `Cmp`, checked at `ModuleBuilder.provision`'s call site (node.ts); `satisfies`
+ * is its runtime mirror, called at Load (graph.ts). Correctness comes from
+ * the kind's builder shaping `Cmp` so assignability means the right thing —
+ * see @prisma/composer/service-rpc's `contract()`/`rpc()`.
+ */
+interface Contract<Kind extends string, Cmp> {
+  readonly kind: Kind;
+  readonly __cmp: Cmp;
+  /** How calls over this contract communicate, if it declares a style. Core only carries it onto the graph's ports. */
+  readonly style?: ContractStyle;
+  satisfies(required: Contract<Kind, unknown>): boolean;
+}
+/** How calls over a contract communicate. A style, not a kind. */
+type ContractStyle = 'request-response' | 'stream';
+//#endregion
 //#region src/config.d.ts
 /**
  * A declared config param — pure data: a caller-owned Standard Schema
@@ -206,22 +226,6 @@ interface Config {
   readonly inputs: Readonly<Record<string, Readonly<Record<string, unknown>>>>;
 }
 //#endregion
-//#region src/contract.d.ts
-/**
- * A Contract is the declared interface of a service-to-service dependency: a
- * protocol brand (`kind`) plus an opaque comparison type (`Cmp`) the core
- * never inspects. Wiring compatibility is plain TypeScript assignability on
- * `Cmp`, checked at `ModuleBuilder.provision`'s call site (node.ts); `satisfies`
- * is its runtime mirror, called at Load (graph.ts). Correctness comes from
- * the kind's builder shaping `Cmp` so assignability means the right thing —
- * see @prisma/composer/service-rpc's `contract()`/`rpc()`.
- */
-interface Contract<Kind extends string, Cmp> {
-  readonly kind: Kind;
-  readonly __cmp: Cmp;
-  satisfies(required: Contract<Kind, unknown>): boolean;
-}
-//#endregion
 //#region src/node.d.ts
 declare const NODE: unique symbol;
 declare const SECRET_NEED: unique symbol;
@@ -335,7 +339,7 @@ interface ServiceNode<D extends Deps = Deps, P extends Params = Params, E extend
 /**
  * A service's dependency slot. At Load the enclosing module wires a
  * producer's ref into it; at run it hydrates a client via Connection. `Req`
- * is the required contract (`unknown` for an untyped end like `http()`).
+ * is the required contract (`unknown` for an untyped end).
  */
 interface DependencyEnd<C = unknown, Req = unknown> {
   readonly [NODE]: true;
@@ -344,7 +348,7 @@ interface DependencyEnd<C = unknown, Req = unknown> {
   readonly name: string;
   readonly type: string;
   readonly connection: Connection<Params, C>;
-  /** The required contract, or `undefined` for an untyped end (e.g. `http()`). */
+  /** The required contract, or `undefined` for an untyped end. */
   readonly required: Req | undefined;
 }
 /** A Module: the same Deps/Expose boundary a service has, around transparent wiring instead of a black-box body — its `body` runs at Load, not at authoring. */
@@ -516,9 +520,11 @@ interface PortEndpoint {
  * input/expose entry, or a resource's one anonymous output (`$out`).
  * `contractKind` is the protocol brand riding the port — a DependencyEnd's
  * `type` on an `in` port, the exposed Contract's `kind` on an `out` port.
+ * `style` is the exposed Contract's declared style; `in` ports carry none.
  */
 interface BoundaryPort extends PortEndpoint {
   readonly contractKind: string | undefined;
+  readonly style: ContractStyle | undefined;
 }
 /**
  * A pre-dereference edge, exactly as authored: module boundaries are
@@ -589,7 +595,7 @@ interface Graph {
   readonly params: readonly ParamBinding[];
 }
 //#endregion
-//#region ../../0-framework/1-core/core/dist/app-config-BqBRS3nH.d.mts
+//#region ../../0-framework/1-core/core/dist/app-config-BBPLNnZX.d.mts
 //#region src/container-transport.d.ts
 /**
  * Carries resolved containers from the CLI process into the alchemy process
@@ -1074,6 +1080,56 @@ interface LocalTargetDescriptor {
   attach(input: LocalTargetAttachInput): Promise<LocalTargetAttachment>;
   /** `--fresh`: remove every local trace of the dev instance — emulator instances, state, data. */
   teardown?(input: TeardownInput): Promise<void>;
+  /**
+   * The app `prisma dev` last ran from a directory, read from its dev state
+   * directory alone — no entry, no graph, no container — so a command can
+   * find or stop a running app without running the pipeline. Undefined when
+   * this extension recorded nothing there.
+   */
+  current?(input: LocalTargetCurrentInput): Promise<LocalTargetCurrentApp | undefined>;
+}
+interface LocalTargetCurrentInput {
+  /** Absolute path of the dev state directory (`<cwd>/.prisma-composer/dev`). */
+  readonly devDir: string;
+}
+/** The app `prisma dev` last ran from a directory, as one extension recorded it. */
+interface LocalTargetCurrentApp {
+  readonly app: string;
+  /** Every node address recorded for the app. */
+  readonly addresses: readonly string[];
+  /** Where the node at `address` runs locally; undefined for an address not recorded. */
+  locate(address: string): Promise<LocalNodeLocation | undefined>;
+  /** Stops everything the target runs for the app (emulators and data persist); returns the nodes it stopped. */
+  stop(): Promise<readonly LocalNodeStopped[]>;
+}
+/** A node's local whereabouts. `kind` is the target's word for the node (for Prisma Cloud: `service`, `database` or `bucket`). */
+type LocalNodeLocation = {
+  readonly address: string;
+  readonly kind: string;
+  readonly emulator: 'running';
+  /** Absent when the emulator no longer has the node's instance. */
+  readonly url?: string;
+  /** The target's word for the node's state, shown to the user. */
+  readonly state: string;
+  readonly condition: LocalNodeCondition;
+  /** Where the node's own output is written, when the target keeps it in a file. */
+  readonly logPath?: string;
+} | {
+  readonly address: string;
+  readonly kind: string;
+  /** The emulator that runs the node is not running, so it has no URL or state to report. */
+  readonly emulator: 'not-running';
+};
+/**
+ * What a node's state means for reaching it: `running` answers at its URL;
+ * `stopped` was stopped and starts with the next `prisma dev`; `crashing`
+ * exited and is being restarted or was held after repeated crashes;
+ * `missing` is recorded but its emulator no longer has it.
+ */
+type LocalNodeCondition = 'running' | 'stopped' | 'crashing' | 'missing';
+interface LocalNodeStopped {
+  readonly address: string;
+  readonly kind: string;
 }
 interface LocalTargetProvidersInput {
   /** This extension's resolved local-target container (its `input.appName` is the emulator app namespace). */
@@ -1107,8 +1163,8 @@ interface LocalTargetAttachment {
     readonly service: string;
     readonly line: string;
   }>;
-  /** Stop the app's service instances (emulators and data persist). */
-  stopServices(): Promise<void>;
+  /** Stop everything the target runs for the app, so nothing of it keeps running after the session (emulators and data persist). */
+  stopApp(): Promise<void>;
 }
 /**
  * What one registry entry can do. The `kind` discriminant is checked at every
@@ -1186,7 +1242,7 @@ type AssembleReport = (data: Readonly<Record<string, string | number>>) => void;
 /** Assembles one service node — the seam tests substitute to avoid a real build. */
 type RunAssembler = (node: ServiceNode, address: string, cwd: string, report?: AssembleReport) => Promise<Bundle>;
 //#endregion
-//#region ../../0-framework/3-tooling/cli/dist/dev-BoBrmouf.d.mts
+//#region ../../0-framework/3-tooling/cli/dist/dev-current-ChYXqIRT.d.mts
 //#region src/composer-config.d.ts
 /** Composer's configuration and the `prisma.config.ts` that declares it. */
 interface ComposerConfigSource {
@@ -1414,6 +1470,12 @@ interface DevInput {
   readonly entry: string;
   readonly name?: string | undefined;
   readonly fresh?: boolean | undefined;
+  /**
+   * Return once every service answers and leave the app running, with no
+   * watch loop: the session is already closed and stopping it stops nothing.
+   * `devStop` stops the app later.
+   */
+  readonly detach?: boolean | undefined;
   readonly cwd?: string | undefined;
   readonly onEvent?: ((event: DevEvent) => void) | undefined;
 }
@@ -1424,9 +1486,9 @@ interface DevSession {
   /** The initial front door, already merged across attachments. */
   readonly endpoints: readonly ServiceEndpoint[];
   /** Stop the watch loop and the app's services (emulators and data stay up).
-   * Idempotent; emits 'stopping'/'stopped'; resolves `closed`. */
+   * Idempotent; emits 'stopping'/'stopped'; resolves `closed`. A no-op for a detached session. */
   stop(): Promise<void>;
-  /** Settles when the session has fully stopped (via stop()). */
+  /** Settles when the session has fully stopped (via stop()); already settled for a detached session. */
   readonly closed: Promise<void>;
 }
 /** In-package variant threading the injection seam, which the family's
@@ -1434,7 +1496,44 @@ interface DevSession {
  * internal types and is not part of the published surface. */
 declare function devWithDeps(input: DevInput, deps: OperationDeps): Promise<Result$1<DevSession, CliStructuredError>>;
 //#endregion
-//#region ../../0-framework/3-tooling/cli/dist/family-Dt7BgpVf.d.mts
+//#region src/operations/dev-current.d.ts
+interface DevUrlInput {
+  /** Composer's configuration: the `composer` section of `prisma.config.ts` and that file. It names the extensions whose local targets recorded the app. */
+  readonly config: ComposerConfigSource;
+  /** A node's dotted address in the app, such as `gateway` or `catalog.database`. */
+  readonly address: string;
+  /** The directory `prisma dev` ran from. Defaults to the process's working directory. */
+  readonly cwd?: string | undefined;
+}
+interface DevUrl {
+  readonly address: string;
+  /** What the node is, in its target's words; Prisma Cloud's are `service`, `database` and `bucket`. */
+  readonly kind: string;
+  /** A service's URL, a database's connection string, or a bucket's S3 endpoint plus `/<bucket>`. */
+  readonly url: string;
+  /** Always `running`: a node that is not running is a failure. */
+  readonly state: string;
+}
+interface DevStopInput {
+  readonly config: ComposerConfigSource;
+  /** The directory `prisma dev` ran from. Defaults to the process's working directory. */
+  readonly cwd?: string | undefined;
+}
+interface DevStopped {
+  /** The app that was stopped: the one `prisma dev` last ran from the directory. */
+  readonly app: string;
+  /** Each node whose process or server was stopped. Data and ports are kept. */
+  readonly stopped: readonly {
+    readonly address: string;
+    readonly kind: string;
+  }[];
+}
+/** Where the node at `input.address` of the directory's current app runs locally. */
+declare function devUrl(input: DevUrlInput): Promise<Result$1<DevUrl, CliStructuredError>>;
+/** Stops the directory's current app: its service processes and database servers. Data and ports stay. */
+declare function devStop(input: DevStopInput): Promise<Result$1<DevStopped, CliStructuredError>>;
+//#endregion
+//#region ../../0-framework/3-tooling/cli/dist/family-BIyR33Uq.d.mts
 //#region src/family/family.d.ts
 /**
  * The control-plane operations the family's handlers call. These are the
@@ -1447,13 +1546,16 @@ declare function devWithDeps(input: DevInput, deps: OperationDeps): Promise<Resu
 interface ComposerOperations {
   readonly deploy: typeof deployWithDeps;
   readonly dev: typeof devWithDeps;
+  readonly devUrl: typeof devUrl;
+  readonly devStop: typeof devStop;
 }
 declare const realOperations: ComposerOperations;
 interface CreateComposerFamilyOptions {
   /** Defaults to the real control operations. */
   readonly operations?: ComposerOperations | undefined;
+  /** More commands to ship in the family, keyed by the path they are meant to mount at. */
+  readonly commands?: CommandFamily['commands'] | undefined;
 }
-declare function createComposerFamily(options?: CreateComposerFamilyOptions): CommandFamily;
 //#endregion
-export { ComposerConfigSource as a, DeploySuccess as c, OperationDeps as d, ServiceEndpoint as f, CliStructuredError as h, realOperations as i, DevInput as l, Result$1 as m, CreateComposerFamilyOptions as n, DeployEvent as o, AssembledServices as p, createComposerFamily as r, DeployInput as s, ComposerOperations as t, DevSession as u };
-//# sourceMappingURL=family-Dt7BgpVf-YyjGLli3.d.mts.map
+export { Result$1 as _, DeployEvent as a, DevInput as c, DevStopped as d, DevUrl as f, AssembledServices as g, ServiceEndpoint as h, ComposerConfigSource as i, DevSession as l, OperationDeps as m, CreateComposerFamilyOptions as n, DeployInput as o, DevUrlInput as p, realOperations as r, DeploySuccess as s, ComposerOperations as t, DevStopInput as u, CliStructuredError as v };
+//# sourceMappingURL=family-BIyR33Uq-BEqJM2Vx.d.mts.map

package/dist/family-BIyR33Uq-BEqJM2Vx.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"family-BIyR33Uq-BEqJM2Vx.d.mts","names":[],"sources":["../../../0-framework/0-foundation/foundation/dist/errors.d.mts","../../../../node_modules/@standard-schema/spec/dist/index.d.ts","../../../0-framework/1-core/core/dist/graph-types-Cegbwb_X.d.mts","../../../0-framework/1-core/core/dist/app-config-BBPLNnZX.d.mts","../../../0-framework/3-tooling/cli/dist/deployment-summary-CU-eVvJM.d.mts","../../../0-framework/0-foundation/foundation/dist/result.d.mts","../../../0-framework/3-tooling/assemble/dist/index.d.mts","../../../0-framework/3-tooling/cli/dist/dev-current-ChYXqIRT.d.mts","../../../0-framework/3-tooling/cli/dist/family-BIyR33Uq.d.mts"],"x_google_ignoreList":[1],"mappings":"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"}

package/dist/family.d.mts

@@ -1,5 +1,5 @@
-import { a as ComposerConfigSource, h as CliStructuredError$1, i as realOperations, n as CreateComposerFamilyOptions, r as createComposerFamily, t as ComposerOperations } from "./family-Dt7BgpVf-YyjGLli3.mjs";
-import { ConfigSection } from "@prisma/cli-engine";
+import { _ as Result, i as ComposerConfigSource, n as CreateComposerFamilyOptions$1, r as realOperations, t as ComposerOperations, v as CliStructuredError$1 } from "./family-BIyR33Uq-BEqJM2Vx.mjs";
+import { CommandFamily, ConfigSection } from "@prisma/cli-engine";
 import { CliStructuredError } from "@prisma/cli-engine/protocol";
 //#region ../../0-framework/3-tooling/cli/dist/family.d.mts
 //#region src/family/section.d.ts
@@ -15,5 +15,49 @@ type ComposerError = CliStructuredError$1;
 /** Translates a composer failure into the engine's error type. Composer-side detail — `meta`, `where`, `docsUrl` — rides along untouched. */
 declare function toEngineError(error: ComposerError): CliStructuredError;
 //#endregion
-export { type ComposerOperations, type CreateComposerFamilyOptions, composerSection, createComposerFamily, realOperations, toEngineError };
+//#region ../../1-prisma-cloud/0-lowering/dev-emulators/dist/index.d.mts
+//#endregion
+//#region src/emulator-list.d.ts
+/** What an emulator's instances are. */
+type EmulatorKind = 'service' | 'database' | 'bucket';
+interface EmulatorInstance {
+  readonly id: string;
+  readonly kind: EmulatorKind;
+  /** A service's URL, a database's connection string, or a bucket's S3 endpoint plus `/<id>`. */
+  readonly url: string;
+  /** A service's status, a database's `running` or `stopped`, or `running` for a bucket. */
+  readonly state: string;
+  readonly labels: Readonly<Record<string, string>>;
+}
+/** Why a running emulator could not be listed: it did not answer, or it answered with an error. */
+interface EmulatorListingError {
+  readonly code: string;
+  readonly message: string;
+}
+interface EmulatorListing {
+  readonly kind: EmulatorKind;
+  readonly running: boolean;
+  /** The emulator's admin URL; null when it is not running. */
+  readonly url: string | null;
+  /** Empty when the emulator is not running or could not be listed. */
+  readonly instances: readonly EmulatorInstance[];
+  /** Null unless the emulator runs but could not be listed. */
+  readonly error: EmulatorListingError | null;
+}
+interface EmulatorList {
+  readonly emulators: readonly EmulatorListing[];
+}
+//#endregion
+//#region src/family/emulator-list.d.ts
+type ListEmulators = () => Promise<Result<EmulatorList, CliStructuredError$1>>;
+//#endregion
+//#region src/exports/family.d.ts
+interface CreateComposerFamilyOptions extends CreateComposerFamilyOptions$1 {
+  /** Defaults to the real listing of this machine's emulators. */
+  readonly listEmulators?: ListEmulators | undefined;
+}
+/** Composer's command family: `deploy`, `dev`, `dev url`, `dev stop` and `emulator list`, keyed by the path each is meant to mount at. */
+declare function createComposerFamily(options?: CreateComposerFamilyOptions): CommandFamily;
+//#endregion
+export { type ComposerOperations, CreateComposerFamilyOptions, type ListEmulators, composerSection, createComposerFamily, realOperations, toEngineError };
 //# sourceMappingURL=family.d.mts.map

package/dist/family.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"family.d.mts","names":[],"sources":["../../../0-framework/3-tooling/cli/dist/family.d.mts"],"mappings":";;;;;cAKc,iBAAiB,cAAc;;;;;;;;KAQxC,gBAAA;;iBAEY,cAAc,OAAO,gBAAgB"}
+{"version":3,"file":"family.d.mts","names":[],"sources":["../../../0-framework/3-tooling/cli/dist/family.d.mts","../../../1-prisma-cloud/0-lowering/dev-emulators/dist/index.d.mts","../src/family/emulator-list.ts","../src/exports/family.ts"],"mappings":";;;;;cAKc,iBAAiB,cAAc;;;;;;;;KAQxC,gBAAA;;iBAEY,cAAc,OAAO,gBAAgB;;;;;;KC4JjD;UAEK;WACC;WACA,MAAM;;WAEN;;WAEA;WACA,QAAQ,SAAS;;;UAGlB;WACC;WACA;;UAED;WACC,MAAM;WACN;;WAEA;;WAEA,oBAAoB;;WAEpB,OAAO;;UAER;WACC,oBAAoB;;;;KCxLnB,sBAAsB,QAAQ,OAAO,cAAc;;;UCc9C,oCAAoC;;WAE1C,gBAAgB;;;iBAIX,qBAAqB,UAAS,8BAAmC"}