@prisma/composer-cli 0.38.0 → 0.39.0-dev.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (47) hide show
  1. package/dist/{app-configuration-file-CeJvBAti-Dk65W3Az.mjs → app-configuration-file-Cw9autUL-CPnePaG6.mjs} +17 -20
  2. package/dist/app-configuration-file-Cw9autUL-CPnePaG6.mjs.map +1 -0
  3. package/dist/{dev-current-D-Qb6Yem-CvaY4xsk.mjs → dev-current-D8GwJQex-D4xWpddG.mjs} +6 -6
  4. package/dist/{dev-current-D-Qb6Yem-CvaY4xsk.mjs.map → dev-current-D8GwJQex-D4xWpddG.mjs.map} +1 -1
  5. package/dist/{dev-environment-name-6eEr5PW8-DpdGjmTb.mjs → dev-environment-name-6eEr5PW8-DuiDkcM6.mjs} +2 -2
  6. package/dist/dev-environment-name-6eEr5PW8-DuiDkcM6.mjs.map +1 -0
  7. package/dist/{dist-BH6HQ6zZ.mjs → dist-qqNor5kl.mjs} +3 -3
  8. package/dist/{dist-BH6HQ6zZ.mjs.map → dist-qqNor5kl.mjs.map} +1 -1
  9. package/dist/{execute-deploy-destroy-C6EsdmLz-DqdToZ_i.mjs → execute-deploy-destroy-1SIH5uAu-SJMSVJ-C.mjs} +26 -14
  10. package/dist/execute-deploy-destroy-1SIH5uAu-SJMSVJ-C.mjs.map +1 -0
  11. package/dist/{execute-dev-current-tBKmDAjV-DOOMGrl5.mjs → execute-dev-current-DsAsDBB1-C_Pqg6lv.mjs} +6 -6
  12. package/dist/{execute-dev-current-tBKmDAjV-DOOMGrl5.mjs.map → execute-dev-current-DsAsDBB1-C_Pqg6lv.mjs.map} +1 -1
  13. package/dist/{execute-dev-gjIKYybU-hRndPEgC.mjs → execute-dev-xPaS5SAl-Pf5LvC3G.mjs} +84 -15
  14. package/dist/{execute-dev-gjIKYybU-hRndPEgC.mjs.map → execute-dev-xPaS5SAl-Pf5LvC3G.mjs.map} +1 -1
  15. package/dist/family.d.mts +1 -1
  16. package/dist/family.mjs +114 -8
  17. package/dist/family.mjs.map +1 -1
  18. package/dist/{generate-dev-stack-BV_n-X9n-BDBjgphH.mjs → generate-dev-stack-BEpqJ3AH-BwP97FIX.mjs} +5 -5
  19. package/dist/generate-dev-stack-BEpqJ3AH-BwP97FIX.mjs.map +1 -0
  20. package/dist/{list-deployed-IL0MgmTX.mjs → list-deployed-B_HjWxgs.mjs} +4 -4
  21. package/dist/list-deployed-B_HjWxgs.mjs.map +1 -0
  22. package/dist/{config-DiZaanS3.mjs → preflight-transport-DJjTWvyH-C98XN-K2.mjs} +18 -6
  23. package/dist/preflight-transport-DJjTWvyH-C98XN-K2.mjs.map +1 -0
  24. package/dist/{redaction-HnbkSFrK-CCKJNRwi.mjs → redaction-C-NnlVUh-xg-a8RGt.mjs} +27 -6
  25. package/dist/redaction-C-NnlVUh-xg-a8RGt.mjs.map +1 -0
  26. package/dist/{redaction-Bf8FvTFH-D0dXGsO8.d.mts → redaction-CqdeMBKw-aZd7lPFP.d.mts} +143 -73
  27. package/dist/redaction-CqdeMBKw-aZd7lPFP.d.mts.map +1 -0
  28. package/dist/{result-sR7PBi61.mjs → result-DlBttLS8.mjs} +7 -2
  29. package/dist/{result-sR7PBi61.mjs.map → result-DlBttLS8.mjs.map} +1 -1
  30. package/dist/{run-alchemy-OS_ix5g0-DSlHsv2p.mjs → run-alchemy-CyciV8i0-Djfa6x3a.mjs} +4 -4
  31. package/dist/{run-alchemy-OS_ix5g0-DSlHsv2p.mjs.map → run-alchemy-CyciV8i0-Djfa6x3a.mjs.map} +1 -1
  32. package/dist/testing.d.mts +5 -10
  33. package/dist/testing.d.mts.map +1 -1
  34. package/dist/testing.mjs +5 -5
  35. package/dist/testing.mjs.map +1 -1
  36. package/dist/{validate-environment-CpQLC3CA-Ct-PXoKN.mjs → validate-environment-DyW59rJ7-B1PoUO20.mjs} +150 -88
  37. package/dist/validate-environment-DyW59rJ7-B1PoUO20.mjs.map +1 -0
  38. package/package.json +11 -11
  39. package/dist/app-configuration-file-CeJvBAti-Dk65W3Az.mjs.map +0 -1
  40. package/dist/config-DiZaanS3.mjs.map +0 -1
  41. package/dist/dev-environment-name-6eEr5PW8-DpdGjmTb.mjs.map +0 -1
  42. package/dist/execute-deploy-destroy-C6EsdmLz-DqdToZ_i.mjs.map +0 -1
  43. package/dist/generate-dev-stack-BV_n-X9n-BDBjgphH.mjs.map +0 -1
  44. package/dist/list-deployed-IL0MgmTX.mjs.map +0 -1
  45. package/dist/redaction-Bf8FvTFH-D0dXGsO8.d.mts.map +0 -1
  46. package/dist/redaction-HnbkSFrK-CCKJNRwi.mjs.map +0 -1
  47. package/dist/validate-environment-CpQLC3CA-Ct-PXoKN.mjs.map +0 -1
@@ -98,7 +98,7 @@ declare class SecretBox<T> {
98
98
  /** The common case: a secret string. */
99
99
  type SecretString = SecretBox<string>;
100
100
  //#endregion
101
- //#region ../../0-framework/0-foundation/foundation/dist/pointer-CyQZZugO.d.mts
101
+ //#region ../../0-framework/0-foundation/foundation/dist/pointer-DclJZFQi.d.mts
102
102
  //#region src/pointer.d.ts
103
103
  declare const POINTER: unique symbol;
104
104
  declare const POINTER_TYPE: unique symbol;
@@ -108,7 +108,7 @@ interface PointerWithKind<T, K extends PointerKind> {
108
108
  readonly [POINTER]: K;
109
109
  readonly [POINTER_TYPE]?: T;
110
110
  }
111
- /** The real value at deploy of a value known only at boot: it names the platform variable that holds the text of a `T`. Its kind is `'secret'` when `T` is a `SecretString` and `'plain'` otherwise. */
111
+ /** The real value at deploy of a value known only at boot: it names the variable on the platform that holds the text of a `T`. Its kind is `'secret'` when `T` is a `SecretString` and `'plain'` otherwise. */
112
112
  type Pointer<T> = PointerWithKind<T, unknown extends T ? PointerKind : T extends SecretString ? 'secret' : 'plain'>;
113
113
  //#endregion
114
114
  //#region ../../../node_modules/@standard-schema/spec/dist/index.d.ts
@@ -188,7 +188,7 @@ declare namespace StandardSchemaV1 {
188
188
  type InferOutput<Schema extends StandardTypedV1> = StandardTypedV1.InferOutput<Schema>;
189
189
  }
190
190
  //#endregion
191
- //#region ../../0-framework/1-core/core/dist/graph-types-BiFZrE06.d.mts
191
+ //#region ../../0-framework/1-core/core/dist/graph-types-Bzj1fahC.d.mts
192
192
  //#region src/contract.d.ts
193
193
  /**
194
194
  * A Contract is the declared interface of a service-to-service dependency: a
@@ -259,6 +259,7 @@ interface Config {
259
259
  //#region src/value.d.ts
260
260
  declare const VALUE: unique symbol;
261
261
  declare const VALUE_ORIGIN: unique symbol;
262
+ declare const VALUE_RESOURCE: unique symbol;
262
263
  declare const VALUE_TYPE: unique symbol;
263
264
  /** Where Load gets a value's real value. Internal to core; not re-exported from the public barrel. */
264
265
  type ValueOrigin<T> = {
@@ -278,34 +279,33 @@ type ValueOrigin<T> = {
278
279
  } | {
279
280
  readonly kind: 'source';
280
281
  readonly sourceKind: 'param';
281
- /** How an error names the source, e.g. `envParam('REGION')`. */
282
+ /** How an error names the source. */
282
283
  readonly label: string;
283
- /** The app configuration key whose text at deploy is the real value, as for `envParam()`. `undefined` for a value known only at boot, whose real value is `source`, a pointer. */
284
- readonly configurationKey: string | undefined;
284
+ readonly resource: NodeId | undefined;
285
285
  /** The source itself. Not enumerable, so a copy's origin compares equal and the origin holds no cycle. */
286
286
  readonly source: ParamSource;
287
287
  } | {
288
288
  readonly kind: 'source';
289
289
  readonly sourceKind: 'secret';
290
- /** How an error names the source, e.g. `envSecret('STRIPE_KEY')`. */
290
+ /** How an error names the source. */
291
291
  readonly label: string;
292
- /** The app secrets key that holds the secret's value, as for `envSecret()`. `undefined` for a secret source built without one. */
292
+ /** The app secrets key that holds the secret's value. `undefined` for a secret source built without one. */
293
293
  readonly secretsKey: string | undefined;
294
+ readonly resource: NodeId | undefined;
294
295
  /** The source itself. Not enumerable, so a copy's origin compares equal and the origin holds no cycle. */
295
296
  readonly source: SecretSource;
296
297
  };
297
298
  /**
298
- * An opaque stand-in a module body can pass wherever a `T` is accepted
299
- * (ADR-0062). `environment.name` is one; each field of a module's `input` is
300
- * one; `resolve()` returns one computed from others; a deploy target's source,
301
- * such as `envParam()` or `envSecret()`, is one too. A deploy-time value's real
302
- * value is known by the end of Load; a runtime value's real value at deploy is a pointer.
299
+ * A stand-in a module body passes wherever a `T` is accepted (ADR-0062): `environment.name`, an input field, a `resolve()` result or a target's source.
300
+ * A deploy-time value is known by the end of Load; a runtime value's real value at deploy is a pointer.
303
301
  */
304
302
  interface Value<T> {
305
303
  readonly [VALUE]: true;
306
304
  readonly [VALUE_TYPE]?: T;
307
305
  readonly [VALUE_ORIGIN]: ValueOrigin<T>;
308
306
  }
307
+ /** A value known only at boot (ADR-0062): its real value at deploy is a `Pointer<T>`, which names the variable on the platform that the service reads at boot. */
308
+ type RuntimeValue<T> = Value<Pointer<T>>;
309
309
  /** Plain data: what a `resolve()` function may return. */
310
310
  type PlainData = string | number | boolean | null | readonly PlainData[] | {
311
311
  readonly [key: string]: PlainData;
@@ -351,7 +351,7 @@ type NotModuleInput = {
351
351
  //#region src/node.d.ts
352
352
  declare const NODE: unique symbol;
353
353
  declare const SECRET_SOURCE: unique symbol;
354
- /** A secret's source: a target-defined payload core forwards but never inspects. It is a value too, known only at boot; its real value at deploy is the source itself, a secret pointer. A target (e.g. @prisma/composer-prisma-cloud's `envSecret`) builds one with `secretSource()`. */
354
+ /** A secret's source: a target-defined payload core forwards but never inspects. It is a value too, known only at boot; its real value at deploy is the source itself, a secret pointer. A target builds one with `secretSource()`. */
355
355
  interface SecretSource<T = unknown> extends Value<unknown> {
356
356
  readonly [SECRET_SOURCE]: true;
357
357
  /** Target-defined. Core never reads this; the target that authored the source reads it back. */
@@ -367,14 +367,14 @@ interface ProvisionNeed<T = unknown> {
367
367
  readonly payload: T;
368
368
  }
369
369
  declare const PARAM_SOURCE: unique symbol;
370
- /** A param's source: a target-defined payload core forwards but never inspects. It is a value too: known at deploy when it names an app configuration key (`envParam`), otherwise known only at boot, with the source itself as its real value: a secret pointer when it is redacted, a plain pointer otherwise. A target builds one with `paramSource()`. */
370
+ /** A param's source: a target-defined payload core forwards but never inspects. It is a value too, known only at boot, with the source itself as its real value: a secret pointer when it is redacted, a plain pointer otherwise. A target builds one with `paramSource()`. */
371
371
  interface ParamSource<T = unknown> extends Value<unknown> {
372
372
  readonly [PARAM_SOURCE]: true;
373
373
  /** Target-defined. Core never reads this; the target that authored the source reads it back. */
374
374
  readonly payload: T;
375
375
  }
376
- /** What `provision(service, { params })` accepts per declared param: a literal (schema-validated when config is built) or an opaque `ParamSource`, taking precedence over `param.default`. Every entry is optional — an unbound param falls back to its `default`. */
377
- type ParamBindings<P extends Params> = { readonly [K in keyof P]?: StandardSchemaV1.InferOutput<P[K]['schema']> | ParamSource | (StandardSchemaV1.InferOutput<P[K]['schema']> extends PlainData ? Value<StandardSchemaV1.InferOutput<P[K]['schema']>> : never); };
376
+ /** What `provision(service, { params })` accepts per declared param: a literal (schema-validated when config is built) or a deploy-time value, taking precedence over `param.default`. Every entry is optional — an unbound param falls back to its `default`. */
377
+ type ParamBindings<P extends Params> = { readonly [K in keyof P]?: StandardSchemaV1.InferOutput<P[K]['schema']> | (StandardSchemaV1.InferOutput<P[K]['schema']> extends PlainData ? Value<StandardSchemaV1.InferOutput<P[K]['schema']>> : never); };
378
378
  /**
379
379
  * What `provision(node, { input })` accepts, for a module or a service, where
380
380
  * the node's input schema expects `T` (its Standard Schema input type): the
@@ -516,8 +516,8 @@ interface AppRootContext<I extends StandardSchemaV1 | undefined = StandardSchema
516
516
  readonly input: I extends StandardSchemaV1 ? ModuleInput<I> : undefined;
517
517
  /** The deploy-time facts of the environment, each a value (ADR-0062). */
518
518
  readonly environment: EnvironmentFacts;
519
- /** Registers an owned child (resource, service or module) under a stable id. */
520
- readonly provision: ModuleBuilder['provision'];
519
+ /** Registers an owned child (resource, service, module or value resource) under a stable id. */
520
+ readonly provision: AppRootProvision;
521
521
  }
522
522
  /**
523
523
  * A module's forwarded-input value: the same ref-port shape a producer's
@@ -590,21 +590,25 @@ type ModuleProvisionOptions<D extends Deps, I extends StandardSchemaV1 | undefin
590
590
  } : unknown);
591
591
  /** The options are optional exactly when nothing is required. */
592
592
  type ModuleProvisionArgs<D extends Deps, I extends StandardSchemaV1 | undefined> = I extends StandardSchemaV1 ? [opts: ModuleProvisionOptions<D, I>] : [keyof D] extends [never] ? [opts?: ModuleProvisionOptions<D, I>] : [opts: ModuleProvisionOptions<D, I>];
593
- /** The options `provision()` takes after a service or module node `N`. */
594
- type ProvisionArgs<N> = N extends ServiceNode<infer D, infer P, Expose, infer I> ? ServiceProvisionArgs<D, I, ParamBindings<P>> : N extends ModuleNode<infer D, Expose, infer I> ? ModuleProvisionArgs<D, I> : never;
593
+ type ProvisionArgs<N> = N extends ValueResourceNode ? [opts?: {
594
+ id?: string;
595
+ }] : N extends ServiceNode<infer D, infer P, Expose, infer I> ? ServiceProvisionArgs<D, I, ParamBindings<P>> : N extends ModuleNode<infer D, Expose, infer I> ? ModuleProvisionArgs<D, I> : never;
595
596
  /** The contracts a service or module node `N` exposes. */
596
597
  type ExposeOf<N> = N extends ServiceNode<Deps, Params, infer E, StandardSchemaV1 | undefined> ? E : N extends ModuleNode<Deps, infer E, StandardSchemaV1 | undefined> ? E : never;
597
- interface ModuleBuilder {
598
+ type OnlyInAppRoot = "Only appRoot() can provision a resource that is a value. Provision it in the app root and pass its value down through this module's input.";
599
+ interface SharedProvision {
598
600
  /** Provisions an owned resource; its id defaults to the node's `name`. */
599
- provision<C extends AnyContract | undefined>(resource: ResourceNode<C>, opts?: {
601
+ <C extends AnyContract | undefined>(resource: ResourceNode<C> & {
602
+ readonly [VALUE_RESOURCE]?: undefined;
603
+ }, opts?: {
600
604
  id?: string;
601
605
  }): {
602
606
  readonly id: string;
603
607
  } & (C extends AnyContract ? RefPort<C> : Record<never, never>);
604
- /** Registers an owned service; its id defaults to the node's `name`; `deps`/`input` are required iff it declares them; a reserved param may be bound (literal or `ParamSource`), overriding its default. */
605
- provision<D extends Deps, P extends Params, E extends Expose, I extends StandardSchemaV1 | undefined>(service: ServiceNode<D, P, E, I>, ...args: ServiceProvisionArgs<D, I, ParamBindings<P>>): ProvisionedRef<E>;
608
+ /** Registers an owned service; its id defaults to the node's `name`; `deps`/`input` are required iff it declares them; a reserved param may be bound (literal or deploy-time value), overriding its default. */
609
+ <D extends Deps, P extends Params, E extends Expose, I extends StandardSchemaV1 | undefined>(service: ServiceNode<D, P, E, I>, ...args: ServiceProvisionArgs<D, I, ParamBindings<P>>): ProvisionedRef<E>;
606
610
  /** Registers an owned child module; its id defaults to the node's `name`; `deps` and `input` are required iff it declares them. */
607
- provision<D extends Deps, E extends Expose, I extends StandardSchemaV1 | undefined>(child: ModuleNode<D, E, I>, ...args: ModuleProvisionArgs<D, I>): ProvisionedRef<E>;
611
+ <D extends Deps, E extends Expose, I extends StandardSchemaV1 | undefined>(child: ModuleNode<D, E, I>, ...args: ModuleProvisionArgs<D, I>): ProvisionedRef<E>;
608
612
  /**
609
613
  * The service call with `deps` written out. `ServiceProvisionArgs` above
610
614
  * cannot resolve while `D` or `I` is still an unbound type parameter — a
@@ -612,40 +616,52 @@ interface ModuleBuilder {
612
616
  * that call site resolves to this overload, or to the next one for a
613
617
  * service without an input schema.
614
618
  */
615
- provision<D extends Deps, P extends Params, E extends Expose, I extends StandardSchemaV1 | undefined>(service: ServiceNode<D, P, E, I>, opts: {
619
+ <D extends Deps, P extends Params, E extends Expose, I extends StandardSchemaV1 | undefined>(service: ServiceNode<D, P, E, I>, opts: {
616
620
  id?: string;
617
621
  deps: DepBindings<D>;
618
622
  input: InputBindingOf<I>;
619
623
  params?: ParamBindings<P>;
620
624
  }): ProvisionedRef<E>;
621
- provision<D extends Deps, P extends Params, E extends Expose>(service: ServiceNode<D, P, E, undefined>, opts: {
625
+ <D extends Deps, P extends Params, E extends Expose>(service: ServiceNode<D, P, E, undefined>, opts: {
622
626
  id?: string;
623
627
  deps: DepBindings<D>;
624
628
  input?: never;
625
629
  params?: ParamBindings<P>;
626
630
  }): ProvisionedRef<E>;
627
631
  /** The child-module call with `deps` written out — the same generic-wrapper escape as the two service overloads above. */
628
- provision<D extends Deps, E extends Expose, I extends StandardSchemaV1 | undefined>(child: ModuleNode<D, E, I>, opts: {
632
+ <D extends Deps, E extends Expose, I extends StandardSchemaV1 | undefined>(child: ModuleNode<D, E, I>, opts: {
629
633
  id?: string;
630
634
  deps: DepBindings<D>;
631
635
  input: InputBindingOf<I>;
632
636
  }): ProvisionedRef<E>;
633
- provision<D extends Deps, E extends Expose>(child: ModuleNode<D, E, undefined>, opts: {
637
+ <D extends Deps, E extends Expose>(child: ModuleNode<D, E, undefined>, opts: {
634
638
  id?: string;
635
639
  deps: DepBindings<D>;
636
640
  input?: never;
637
641
  }): ProvisionedRef<E>;
638
- /**
639
- * Any service or child module. Declared last, so a call no overload accepts
640
- * reports this overload's error, which names the binding key that does not
641
- * fit, or says a module's whole input is not a value.
642
- */
643
- provision<N extends ServiceNode | ModuleNode>(node: N, ...args: ProvisionArgs<N>): ProvisionedRef<ExposeOf<N>>;
644
642
  }
643
+ type ProvisionInModule = <N extends ServiceNode | ModuleNode | ValueResourceNode>(node: N extends ValueResourceNode ? OnlyInAppRoot : N, ...args: ProvisionArgs<N>) => ProvisionedRef<ExposeOf<N>>;
644
+ type ProvisionValue = <V extends SourceValue>(node: ValueResourceNode<V>, opts?: {
645
+ readonly id?: string;
646
+ }) => V & {
647
+ readonly id: string;
648
+ };
649
+ type ProvisionInAppRoot = <N extends ServiceNode | ModuleNode | ValueResourceNode>(node: N, ...args: ProvisionArgs<N>) => ProvisionedRef<ExposeOf<N>>;
650
+ interface ModuleBuilder {
651
+ /** Registers an owned child (resource, service or module) under a stable id. */
652
+ readonly provision: SharedProvision & ProvisionInModule;
653
+ }
654
+ type AppRootProvision = ProvisionValue & SharedProvision & ProvisionInAppRoot;
645
655
  /** Dependency map: name → the slot the service declares. Only declarations are admitted, never a concrete ResourceNode. */
646
656
  type Deps = Record<string, DependencyEnd<any, any>>;
647
657
  /** Output-port map: name → the Contract a service exposes for others to depend on. */
648
658
  type Expose = Readonly<Record<string, AnyContract>>;
659
+ /** What a value resource holds: a secret source or a param source, known only at boot. */
660
+ type SourceValue = (SecretSource | ParamSource) & RuntimeValue<unknown>;
661
+ /** A resource node that is also a value. Only `provision()` in an app root's body takes its value out. It provides no contract and has no dependencies. */
662
+ type ValueResourceNode<V extends SourceValue = SourceValue> = ResourceNode<undefined, Record<never, never>> & {
663
+ readonly [VALUE_RESOURCE]: V;
664
+ };
649
665
  //#endregion
650
666
  //#region src/graph-types.d.ts
651
667
  /** Path-derived: root-scope children are bare ids ("auth", "db"); a nested module's own children dot-join under its address ("auth.db"). */
@@ -665,8 +681,6 @@ interface RootInputField {
665
681
  interface AppConfigurationRead {
666
682
  /** Each field of the root's input that its body names, as the root's schema produced it. Empty when the root declares no input. */
667
683
  readonly rootInput: readonly RootInputField[];
668
- /** The text the app configuration holds for each configuration key a source reads, such as `envParam('NAME')`'s `NAME`. A key the app configuration does not hold, or holds as `''`, is absent. */
669
- readonly configurationKeyText: Readonly<Record<string, string>>;
670
684
  }
671
685
  interface GraphNode {
672
686
  readonly id: NodeId;
@@ -732,31 +746,32 @@ interface InputBindingUse {
732
746
  /** The binding object supplied at provision. */
733
747
  readonly binding: unknown;
734
748
  }
735
- /**
736
- * A resolved param binding: a `provision()` call bound a service's param
737
- * slot to either a literal value or an opaque `ParamSource` — the non-secret
738
- * sibling of `SecretBinding`. Unlike a secret, a param binding is not
739
- * required for every declared param (a param may fall back to its own
740
- * `default`), so this list only carries the ones a `provision()` call
741
- * actually bound.
742
- */
743
749
  interface ParamBinding {
744
750
  /** The graph address of the service that declares the param. */
745
751
  readonly serviceAddress: NodeId;
746
752
  /** The param name on that service. */
747
753
  readonly slot: string;
748
- /** A literal value (schema-validated by `buildConfig`) or an opaque `ParamSource` (the deploy target reads its own payload back) — check with `isParamSource`. Core never inspects a `ParamSource`'s payload. */
754
+ /** A literal value, schema-validated by `buildConfig`. */
749
755
  readonly binding: unknown;
750
756
  }
751
- /** A secret source a binding in the graph names, wherever it sits (ADR-0029). Deploy preflight checks every one, including one in a module's input that no service receives. */
757
+ /** A secret source a binding in the graph names, or a secret value resource, wherever it sits (ADR-0029). Deploy preflight checks every one, including one in a module's input that no service receives. */
752
758
  interface SecretSourceUse {
753
759
  /** The source, as its target built it. Core never reads its payload. */
754
760
  readonly source: SecretSource;
755
- /** A service whose final binding holds it, if one does. Otherwise the module whose input holds it. */
761
+ /** A service whose final binding holds it, if one does. Otherwise the secret value resource itself, or the module whose input holds it. */
756
762
  readonly address: NodeId;
757
763
  /** That node's kind. */
758
764
  readonly nodeKind: 'service' | 'module' | 'resource';
759
765
  }
766
+ /** One service reading one value resource's value. */
767
+ interface ValueRead {
768
+ /** The service whose resolved binding holds the value. */
769
+ readonly reader: NodeId;
770
+ /** The address of the value resource. */
771
+ readonly resource: NodeId;
772
+ /** The dotted key path in the service's input binding; `''` for the whole binding. */
773
+ readonly path: string;
774
+ }
760
775
  interface Graph {
761
776
  readonly root: GraphNode;
762
777
  /** Root + one per input, topo-ordered (deps first). */
@@ -768,15 +783,17 @@ interface Graph {
768
783
  readonly authoredEdges: readonly AuthoredEdge[];
769
784
  /** Every service input binding a `provision()` call supplied (ADR-0042). */
770
785
  readonly inputBindings: readonly InputBindingUse[];
771
- /** Every service param bound at provision — literal or source; unbound params are absent here and fall back to their `default` (see `buildConfig`). */
786
+ /** Every service param bound at provision; unbound params are absent here and fall back to their `default` (see `buildConfig`). */
772
787
  readonly params: readonly ParamBinding[];
773
- /** Every secret source a binding names, once each, in the order Load met them (ADR-0029). */
788
+ /** Every secret source a binding names, and every secret value resource, once each (ADR-0029). */
774
789
  readonly secretSources: readonly SecretSourceUse[];
790
+ /** Each service that reads a value resource's value, and where in its binding it reads it. */
791
+ readonly valueReads: readonly ValueRead[];
775
792
  /** What this Load read from the app configuration (ADR-0062). Empty when Load was given none. */
776
793
  readonly appConfigurationRead: AppConfigurationRead;
777
794
  }
778
795
  //#endregion
779
- //#region ../../0-framework/1-core/core/dist/app-config-lMqqcFA1.d.mts
796
+ //#region ../../0-framework/1-core/core/dist/app-config-_XNdvjus.d.mts
780
797
  //#region src/container-transport.d.ts
781
798
  /**
782
799
  * Carries resolved containers from the CLI process into the alchemy process
@@ -850,6 +867,26 @@ interface ContainerDescriptor<I extends ContainerInstance = ContainerInstance, C
850
867
  //#region src/preflight-transport.d.ts
851
868
  /** A string only this extension reads back, or `undefined` when it has nothing to carry. */
852
869
  type PreflightPayload = string | undefined;
870
+ /** Where a platform variable is named: a service's input field, or a resource no service reads. */
871
+ type PlatformVariableReader = {
872
+ readonly kind: 'field';
873
+ readonly service: string;
874
+ readonly path: string;
875
+ } | {
876
+ readonly kind: 'unread';
877
+ readonly node: string;
878
+ };
879
+ /** A platform variable with no value that nothing requires, with its readers and the commands that set it. */
880
+ interface UnsetPlatformVariable {
881
+ readonly name: string;
882
+ readonly readers: readonly PlatformVariableReader[];
883
+ /** Shell commands that each set it, in the order to offer them. */
884
+ readonly commands: readonly string[];
885
+ }
886
+ /** What a deploy preflight found that does not stop the deploy. Names and readers only, never a value. */
887
+ interface PreflightFindings {
888
+ readonly unset: readonly UnsetPlatformVariable[];
889
+ }
853
890
  //#endregion
854
891
  //#region src/control/deploy.d.ts
855
892
  /** The Layer shape every Alchemy state store must satisfy — what `LowerOptions.state` and `PrismaAppConfig.state` both traffic in. */
@@ -1014,13 +1051,15 @@ interface DeployedNode {
1014
1051
  interface DeploymentResult {
1015
1052
  readonly app: string;
1016
1053
  readonly nodes: readonly DeployedNode[];
1054
+ /** What every extension's deploy preflight found that did not stop the deploy. */
1055
+ readonly findings: PreflightFindings;
1017
1056
  }
1018
1057
  interface LowerOptions {
1019
1058
  /** Stack + root node id. */
1020
1059
  readonly name: string;
1021
1060
  /** The environment being deployed, as `--environment` gave it. Required by any value over `environment.name`; the generated stack files always pass it. */
1022
1061
  readonly environment?: string;
1023
- /** What the first process's Load read from the app configuration (ADR-0062), from the app configuration file. Load takes the root's input and every configuration key's text from it, and the Prisma Cloud serializer reads a service's `envParam()` leaves from its `configurationKeyText`. The generated stack files pass it. */
1062
+ /** What the first process's Load read from the app configuration (ADR-0062), from the app configuration file. Load takes the root's input from it. The generated stack files pass it. */
1024
1063
  readonly appConfigurationRead?: AppConfigurationRead;
1025
1064
  /** The node addresses of the graph the first process built. When given, lowering refuses a graph whose addresses differ. The generated stack files pass them. */
1026
1065
  readonly firstProcessNodeAddresses?: readonly string[];
@@ -1108,19 +1147,22 @@ interface ExtensionDescriptor {
1108
1147
  readonly application?: ApplicationDescriptor;
1109
1148
  /** The extension's Alchemy providers — merged across all configured extensions (config order). */
1110
1149
  readonly providers?: () => Layer.Layer<never>;
1150
+ /** Refuses a loaded graph this extension cannot deploy by throwing `GraphCheckError`. The CLI calls it right after Load in every command that runs Load. Any other throw is a bug. */
1151
+ readonly checkGraph?: (graph: Graph) => void;
1111
1152
  /**
1112
1153
  * Deploy-time prerequisite check — the CLI runs it once, after the app's
1113
1154
  * Project/Branch are resolved and BEFORE any stack file is written or Alchemy
1114
1155
  * runs. A target uses it to verify platform prerequisites (e.g. that every
1115
- * secret env var in the provision manifest exists for the resolved environment) and
1116
- * throws to abort the deploy. Async: it talks to the platform (ADR-0029).
1156
+ * platform variable a service needs has a value) and throws to abort the
1157
+ * deploy. Async: it talks to the platform (ADR-0064).
1117
1158
  *
1118
1159
  * What it returns is carried to the alchemy process for this same extension
1119
1160
  * to read back there (preflight-transport.ts) — preflight runs in the CLI
1120
1161
  * parent, and the alchemy child re-imports the config from scratch, so
1121
1162
  * anything the lowering needs from it must ride that transport. The payload
1122
1163
  * is the extension's own opaque string; the framework never reads it, and a
1123
- * secret value must never go in it.
1164
+ * secret value must never go in it. What it hands `input.report` reaches the
1165
+ * deploy report through the framework's own transport, not this payload.
1124
1166
  *
1125
1167
  * METHOD SYNTAX REQUIRED, for the same reason ContainerDescriptor's members
1126
1168
  * need it: the framework hands over the erased `PreflightInput<unknown>`,
@@ -1183,17 +1225,21 @@ interface PreflightInput<C = unknown> {
1183
1225
  readonly container: ContainerInstance | undefined;
1184
1226
  /** The environment name. */
1185
1227
  readonly environment: string;
1186
- /** The app configuration the command read for this environment. Preflight fills a missing `envParam()` param's platform variable from it. */
1228
+ /** The app configuration the command read for this environment. */
1187
1229
  readonly configuration: AppConfiguration;
1188
- /** The app secrets the command read for this environment. Preflight fills a missing `envSecret()` platform variable from it. */
1230
+ /** The app secrets the command read for this environment. */
1189
1231
  readonly secrets: AppSecrets;
1190
1232
  /** What the caller has already authenticated, for the platform calls preflight makes. Absent means the extension falls back to its own credential protocol. */
1191
1233
  readonly credentials?: ContainerCredentials<C> | undefined;
1192
- /** Hands the deploy's progress output what the check covered, as counts (e.g. `{ checked: 53, filled: 0, missing: 0 }`). Counts only: never a name or a value. */
1193
- readonly report?: ((counts: Readonly<Record<string, number>>) => void) | undefined;
1234
+ /** Hands the deploy how many platform variables the check read and which have no value. */
1235
+ readonly report?: ((check: PlatformVariableCheck) => void) | undefined;
1194
1236
  /** Shows the user a warning that does not stop the run. Only `prisma dev` passes it and shows the warnings; deploy passes none. */
1195
1237
  readonly warn?: ((message: string) => void) | undefined;
1196
1238
  }
1239
+ /** What a deploy preflight's check of platform variables found: how many it read, and the ones with no value that nothing requires. */
1240
+ interface PlatformVariableCheck extends PreflightFindings {
1241
+ readonly checked: number;
1242
+ }
1197
1243
  /** The resolved destroy context handed to an extension's `teardown` hook. */
1198
1244
  interface TeardownInput {
1199
1245
  /** The calling extension's own resolved container; `undefined` when it declares no container descriptor. Narrow with the extension's guard. */
@@ -1296,8 +1342,8 @@ interface LocalTargetDescriptor {
1296
1342
  providers(input: LocalTargetProvidersInput): Layer.Layer<never>;
1297
1343
  /** A stable local identity — resolved without any platform call. */
1298
1344
  readonly container: ContainerDescriptor;
1299
- /** Value sourcing (secrets/env-params) — runs where deploy's preflight runs. What it returns reaches the alchemy process the same way deploy's preflight payload does. */
1300
- preflight?(input: PreflightInput): Promise<PreflightPayload>;
1345
+ /** Works out the platform variables' values, where deploy's preflight runs. Its payload reaches the alchemy process the same way deploy's preflight payload does. */
1346
+ preflight?(input: PreflightInput): Promise<DevPreflightResult>;
1301
1347
  /** Ensure the emulator daemons this topology's node kinds need are running, plus any per-node emulator state that must exist before converge (idempotent; daemons persist across sessions). */
1302
1348
  emulators?(input: LocalTargetEmulatorsInput): Promise<void>;
1303
1349
  /** The dev session's view of the running app. Core renders it and never learns an emulator's API. */
@@ -1312,6 +1358,12 @@ interface LocalTargetDescriptor {
1312
1358
  */
1313
1359
  current?(input: LocalTargetCurrentInput): Promise<LocalTargetCurrentApp | undefined>;
1314
1360
  }
1361
+ /** What a local target's preflight found. */
1362
+ interface DevPreflightResult {
1363
+ readonly payload: PreflightPayload;
1364
+ /** The text of each plain platform variable a service reads, by name. Never a secret. */
1365
+ readonly plainVariableText: Readonly<Record<string, string>>;
1366
+ }
1315
1367
  interface LocalTargetCurrentInput {
1316
1368
  /** Absolute path of the environment's dev state directory (`devEnvironmentDir`, under the cwd). */
1317
1369
  readonly devDir: string;
@@ -1364,9 +1416,9 @@ interface LocalTargetProvidersInput {
1364
1416
  readonly container: ContainerInstance | undefined;
1365
1417
  /** Absolute path of the environment's dev state directory (`devEnvironmentDir`, under the cwd). */
1366
1418
  readonly devDir: string;
1367
- /** The text of each configuration key the graph reads, from the app configuration file. A local deployment takes the text its param rows point at from it. */
1368
- readonly configurationKeyText: Readonly<Record<string, string>>;
1369
- /** The app secrets the graph's `envSecret()`s name, which the first process handed the second. A local deployment takes the text its `$secret` pointers name from it. */
1419
+ /** The text of each plain platform variable a service reads, by name. Never a secret. */
1420
+ readonly plainVariableText: Readonly<Record<string, string>>;
1421
+ /** The app secrets the graph's platform secrets name, which the first process handed the second. A local deployment takes the text its secret `$platform` markers name from it. */
1370
1422
  readonly namedSecrets: NamedSecrets;
1371
1423
  }
1372
1424
  interface LocalTargetEmulatorsInput {
@@ -1416,6 +1468,12 @@ interface LocalTargetAttachment {
1416
1468
  }>;
1417
1469
  /** Stop everything the target runs for the app, so nothing of it keeps running after the session (emulators and data persist). */
1418
1470
  stopApp(): Promise<void>;
1471
+ /**
1472
+ * Does what `stopApp()` does and returns only once it is done, without the event loop: for a
1473
+ * process that is exiting and cannot await. Optional: without it, an exit that interrupts
1474
+ * `stopApp()` leaves the app running.
1475
+ */
1476
+ stopAppBeforeExit?(): void;
1419
1477
  }
1420
1478
  /**
1421
1479
  * What one registry entry can do. The `kind` discriminant is checked at every
@@ -1446,11 +1504,11 @@ interface ConfigAdapterInput {
1446
1504
  type ConfigValues = Readonly<Record<string, unknown>>;
1447
1505
  /** A function in the `config` or `secrets` list of the `composer` section (ADR-0062): it receives the environment and returns that environment's values. Only the command's first process calls it; the second process reads what the first read from the app configuration file. */
1448
1506
  type ConfigAdapter = (input: ConfigAdapterInput) => ConfigValues | Promise<ConfigValues>;
1449
- /** The app configuration (ADR-0062): what the `config` adapters return, merged by top-level key, a later adapter winning. It is the root's input, and what `envParam()` reads. */
1507
+ /** The app configuration (ADR-0062): what the `config` adapters return, merged by top-level key, a later adapter winning. It is the root's input, and under `prisma dev` it also holds the text of each plain platform variable. */
1450
1508
  type AppConfiguration = Readonly<Record<string, unknown>>;
1451
- /** The app secrets (ADR-0062): what the `secrets` adapters return, merged the same way. Every value is text. Preflight fills a missing `envSecret()` platform variable from it, and `prisma dev` hands its second process the values the graph's `envSecret()`s name. Composer redacts the values the graph's `envSecret()`s name wherever it prints. */
1509
+ /** The app secrets (ADR-0062): what the `secrets` adapters return, merged the same way. Every value is text. Nothing fills a platform variable from them. `prisma dev` hands its second process the values under the secrets keys of the graph's secret sources, and Composer redacts those values wherever it prints. */
1452
1510
  type AppSecrets = Readonly<Record<string, string>>;
1453
- /** The app secrets an `envSecret()` in the graph names, each with text. `prisma dev`'s first process hands them to its second process in `PRISMA_COMPOSER_NAMED_SECRETS`. */
1511
+ /** The app secrets under the secrets keys of the graph's secret sources, each with text. `prisma dev`'s first process hands them to its second process in `PRISMA_COMPOSER_NAMED_SECRETS`. */
1454
1512
  type NamedSecrets = Readonly<Record<string, string>>;
1455
1513
  /**
1456
1514
  * The config file's default export. `extensions` lists every extension the
@@ -1511,7 +1569,7 @@ interface NotOk<F> {
1511
1569
  */
1512
1570
  type Result$1<T, F> = Ok<T> | NotOk<F>;
1513
1571
  //#endregion
1514
- //#region ../../0-framework/3-tooling/cli/dist/dev-Df-kx6UV.d.mts
1572
+ //#region ../../0-framework/3-tooling/cli/dist/dev-DDe8SH4o.d.mts
1515
1573
  //#region src/composer-config.d.ts
1516
1574
  /** Composer's configuration and the `prisma.config.ts` that declares it. */
1517
1575
  interface ComposerConfigSource {
@@ -1669,6 +1727,13 @@ type DevEvent =
1669
1727
  {
1670
1728
  readonly kind: 'values-changed';
1671
1729
  } |
1730
+ /** The value resources the app reads changed since the session started. `added` holds the nodes whose reads were only added, `removed` those whose reads were only removed, and `changed` every other changed node, each by address. The session stops rebuilding until it is restarted. */
1731
+ {
1732
+ readonly kind: 'value-reads-changed';
1733
+ readonly added: readonly string[];
1734
+ readonly removed: readonly string[];
1735
+ readonly changed: readonly string[];
1736
+ } |
1672
1737
  /** The app keeps running, still watching. */
1673
1738
  {
1674
1739
  readonly kind: 'converge-failed';
@@ -1755,7 +1820,7 @@ interface DeploymentSummary {
1755
1820
  readonly nodes: readonly DeployedNodeSummary[];
1756
1821
  }
1757
1822
  //#endregion
1758
- //#region ../../0-framework/3-tooling/cli/dist/dev-current-BPnQtqnQ.d.mts
1823
+ //#region ../../0-framework/3-tooling/cli/dist/dev-current-BuX95QnN.d.mts
1759
1824
  //#region src/operations/deploy.d.ts
1760
1825
  /** A deploy step. `assemble-service` steps run inside `assemble`, one per service. */
1761
1826
  type DeployStep = {
@@ -1774,6 +1839,11 @@ type DeployEvent = {
1774
1839
  readonly durationMs: number;
1775
1840
  /** What the step measured, as its build adapter or deploy target reported it. The fields vary by adapter and target. */
1776
1841
  readonly data?: Readonly<Record<string, string | number>> | undefined;
1842
+ } |
1843
+ /** Right after the preflight step, when it found platform variables with no value that no service needs. */
1844
+ {
1845
+ readonly kind: 'preflight-findings';
1846
+ readonly findings: PreflightFindings;
1777
1847
  };
1778
1848
  /** The environment `deploy` targets when none is named. */
1779
1849
  declare const DEFAULT_DEPLOY_ENVIRONMENT = "production";
@@ -1868,7 +1938,7 @@ declare function devUrl(input: DevUrlInput): Promise<Result$1<DevUrl, CliStructu
1868
1938
  /** Stops the app's local copy in the environment: its service processes and database servers. Data and ports stay. */
1869
1939
  declare function devStop(input: DevStopInput): Promise<Result$1<DevStopped, CliStructuredError>>;
1870
1940
  //#endregion
1871
- //#region ../../0-framework/3-tooling/cli/dist/family-qagovuqK.d.mts
1941
+ //#region ../../0-framework/3-tooling/cli/dist/family-CUPY2qjp.d.mts
1872
1942
  //#region src/family/family.d.ts
1873
1943
  /**
1874
1944
  * The control-plane operations the family's handlers call. These are the
@@ -1894,7 +1964,7 @@ interface CreateComposerFamilyOptions {
1894
1964
  readonly redirects?: readonly RedirectSpec[] | undefined;
1895
1965
  }
1896
1966
  //#endregion
1897
- //#region ../../0-framework/3-tooling/cli/dist/redaction-Bf8FvTFH.d.mts
1967
+ //#region ../../0-framework/3-tooling/cli/dist/redaction-CqdeMBKw.d.mts
1898
1968
  //#region src/redaction.d.ts
1899
1969
  /** A value under a secrets key, with that key. */
1900
1970
  interface KnownSecret {
@@ -1920,4 +1990,4 @@ declare class KnownSecrets {
1920
1990
  }
1921
1991
  //#endregion
1922
1992
  export { CliStructuredError as C, AppConfigurationRead as S, OperationDeps as _, DEFAULT_DEPLOY_ENVIRONMENT as a, AssembledServices as b, DeploySuccess as c, DevUrl as d, DevUrlInput as f, DevSession as g, DevInput as h, realOperations as i, DevStopInput as l, DevEvent as m, ComposerOperations as n, DeployEvent as o, ComposerConfigSource as p, CreateComposerFamilyOptions as r, DeployInput as s, KnownSecrets as t, DevStopped as u, ServiceEndpoint as v, AppSecrets as x, Result$1 as y };
1923
- //# sourceMappingURL=redaction-Bf8FvTFH-D0dXGsO8.d.mts.map
1993
+ //# sourceMappingURL=redaction-CqdeMBKw-aZd7lPFP.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"redaction-CqdeMBKw-aZd7lPFP.d.mts","names":[],"sources":["../../../0-framework/0-foundation/foundation/dist/errors.d.mts","../../../0-framework/0-foundation/foundation/dist/secret-CHOw4LBU.d.mts","../../../0-framework/0-foundation/foundation/dist/pointer-DclJZFQi.d.mts","../../../../node_modules/@standard-schema/spec/dist/index.d.ts","../../../0-framework/1-core/core/dist/graph-types-Bzj1fahC.d.mts","../../../0-framework/1-core/core/dist/app-config-_XNdvjus.d.mts","../../../0-framework/3-tooling/assemble/dist/index.d.mts","../../../0-framework/0-foundation/foundation/dist/result.d.mts","../../../0-framework/3-tooling/cli/dist/dev-DDe8SH4o.d.mts","../../../0-framework/3-tooling/cli/dist/deployment-summary-p88NV5m5.d.mts","../../../0-framework/3-tooling/cli/dist/dev-current-BuX95QnN.d.mts","../../../0-framework/3-tooling/cli/dist/family-CUPY2qjp.d.mts","../../../0-framework/3-tooling/cli/dist/redaction-CqdeMBKw.d.mts"],"x_google_ignoreList":[3],"mappings":"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"}
@@ -136,6 +136,11 @@ var CliStructuredError = class extends Error {
136
136
  return candidate.name === "CliStructuredError" && typeof candidate.code === "string" && typeof candidate.toEnvelope === "function";
137
137
  }
138
138
  };
139
+ function quotedList(names) {
140
+ const quoted = names.map((name) => `"${name}"`);
141
+ const last = quoted.pop() ?? "";
142
+ return quoted.length === 0 ? last : `${quoted.join(", ")} and ${last}`;
143
+ }
139
144
  //#endregion
140
145
  //#region ../../0-framework/0-foundation/foundation/dist/result.mjs
141
146
  /**
@@ -224,6 +229,6 @@ function okVoid() {
224
229
  return OK_VOID;
225
230
  }
226
231
  //#endregion
227
- export { InternalError as a, CliStructuredError as i, ok as n, blindCast as o, okVoid as r, notOk as t };
232
+ export { quotedList as a, CliStructuredError as i, ok as n, InternalError as o, okVoid as r, blindCast as s, notOk as t };
228
233
 
229
- //# sourceMappingURL=result-sR7PBi61.mjs.map
234
+ //# sourceMappingURL=result-DlBttLS8.mjs.map