npm - @ankhorage/contracts - Versions diffs - 26.6.0 → 26.7.0 - Mend

@ankhorage/contracts 26.6.0 → 26.7.0

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 (19) hide show

package/CHANGELOG.md +6 -0
package/README.md +1 -1
package/dist/flow.d.ts +239 -0
package/dist/flow.d.ts.map +1 -0
package/dist/flow.js +2 -0
package/dist/flow.js.map +1 -0
package/dist/index.d.ts +1 -0
package/dist/index.d.ts.map +1 -1
package/dist/index.js +1 -0
package/dist/index.js.map +1 -1
package/dist/structure/generated.d.ts +2 -2
package/dist/structure/generated.js +2 -2
package/dist/structure/generated.js.map +1 -1
package/package.json +6 -2
package/src/flow.test.ts +218 -0
package/src/flow.ts +254 -0
package/src/flowPackedConsumer.test.ts +98 -0
package/src/index.ts +1 -0
package/src/structure/generated.ts +2 -2

package/CHANGELOG.md CHANGED Viewed

@@ -1,5 +1,11 @@
 # @ankhorage/contracts
+## 26.7.0
+### Minor Changes
+- 63ff295: Add portable Flow graph, execution, approval, data-reference, secret-reference, and provider-capability contracts through the `@ankhorage/contracts/flow` public subpath.
 ## 26.6.0
 ### Minor Changes

package/README.md CHANGED Viewed

@@ -3,7 +3,7 @@
 # @ankhorage/contracts
-![license: MIT](././paradox/badges/license.svg) ![npm: v26.6.0](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![paradox: warnings](././paradox/badges/docs.svg)
+![license: MIT](././paradox/badges/license.svg) ![npm: v26.7.0](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![paradox: warnings](././paradox/badges/docs.svg)
 Serializable app, capability, binding, theme, auth, and secret-store contracts for Ankhorage.

package/dist/flow.d.ts ADDED Viewed

@@ -0,0 +1,239 @@
+import type { DataSchemaSlot } from './data/schemas.js';
+import type { DataContractValue } from './data/values.js';
+import type { SecretRef } from './secrets.js';
+export type FlowId = string;
+export type FlowNodeId = string;
+export type FlowPortId = string;
+export type FlowEdgeId = string;
+export type FlowRunId = string;
+export type FlowStepId = string;
+export type FlowArtifactId = string;
+export type FlowProviderCapabilityId = string;
+/** A serializable reference to a provider-owned flow capability. */
+export interface FlowProviderCapabilityRef {
+    readonly providerId: string;
+    readonly capabilityId: FlowProviderCapabilityId;
+}
+/** A persisted artifact reference for data too large or unsuitable for inline graph data. */
+export interface FlowArtifactRef {
+    readonly kind: 'artifact';
+    readonly artifactId: FlowArtifactId;
+    readonly mediaType?: string;
+    readonly byteLength?: number;
+    readonly checksum?: string;
+}
+/*** A schema-agnostic inline data reference.
+ *
+ * Inline values are ordinary non-secret data. Consumers must reject a value at a credential
+ * configuration position and require a `FlowSecretRef` there; TypeScript cannot prove that
+ * invariant after JSON has crossed a trust boundary.
+ */
+export interface FlowInlineDataRef {
+    readonly kind: 'inline';
+    readonly value: DataContractValue;
+}
+/** A schema-agnostic data reference exchanged by node ports, runs, and traces. */
+export type FlowDataRef = FlowArtifactRef | FlowInlineDataRef;
+/*** A secret-store reference that deliberately excludes secret material.
+ *
+ * @security flow.test.ts#accepts secret references but excludes inline secret material from their contract
+ *
+ * Credential configuration must use this reference. Flow consumers must validate provider
+ * configuration at their boundary, reject inline credentials, and redact secrets from errors and
+ * traces. This portable DTO cannot determine which arbitrary provider fields are credentials, so
+ * it provides no runtime validation and makes no static guarantee for untyped JSON.
+ */
+export interface FlowSecretRef {
+    readonly kind: 'secret';
+    readonly ref: SecretRef;
+}
+/*** JSON-safe node configuration references.
+ *
+ * A configuration value is always explicitly either non-secret data or a secret-store reference;
+ * raw JSON values are intentionally not accepted. Provider consumers own validation of the
+ * declared configuration shape and credential positions before execution.
+ */
+export type FlowNodeConfigValue = FlowDataRef | FlowSecretRef;
+export type FlowNodeConfig = Readonly<Record<string, FlowNodeConfigValue>>;
+/** A typed node port. Direction determines whether a node consumes or produces the port value. */
+export interface FlowPortDescriptor {
+    readonly id: FlowPortId;
+    readonly direction: 'input' | 'output';
+    readonly label?: string;
+    readonly description?: string;
+    readonly required?: boolean;
+    readonly data?: DataSchemaSlot;
+}
+/** One provider-backed executable step within a portable flow graph. */
+export interface FlowNode {
+    readonly id: FlowNodeId;
+    readonly capability: FlowProviderCapabilityRef;
+    readonly label?: string;
+    readonly config?: FlowNodeConfig;
+    readonly ports: readonly FlowPortDescriptor[];
+}
+/*** A condition declared on an edge without embedding executable expressions.
+ *
+ * A `value` condition evaluates `path` as an RFC 6901 JSON Pointer against the source port's
+ * JSON value; the empty string denotes the complete value. Missing-pointer evaluation does not
+ * match. `equals` uses JSON structural equality: values have the same type and recursive array
+ * order and object member/value pairs, independent of object member order. Engines must not use
+ * coercion, locale comparison, or executable expressions.
+ */
+export type FlowEdgeCondition = {
+    readonly kind: 'always';
+} | {
+    readonly kind: 'outcome';
+    readonly outcome: 'failure' | 'success';
+} | {
+    readonly kind: 'value';
+    readonly path: string;
+    readonly equals: DataContractValue;
+};
+/** A directed connection from one output port to one input port. */
+export interface FlowEdge {
+    readonly id: FlowEdgeId;
+    readonly source: {
+        readonly nodeId: FlowNodeId;
+        readonly portId: FlowPortId;
+    };
+    readonly target: {
+        readonly nodeId: FlowNodeId;
+        readonly portId: FlowPortId;
+    };
+    readonly condition?: FlowEdgeCondition;
+}
+/*** A portable trigger declaration; runtime scheduling and delivery remain provider-owned.
+ *
+ * A schedule uses a five-field POSIX cron expression: minute, hour, day of month, month, and day
+ * of week. Seconds, years, macros, and implementation-specific extensions are invalid. `timezone`
+ * is an IANA time-zone name and defaults to `Etc/UTC`. Match it against local wall-clock time; a
+ * spring-forward nonexistent local time is skipped and each occurrence of a repeated local time
+ * during a fall-back transition fires separately. When both day-of-month and day-of-week are
+ * restricted, either match is sufficient, following POSIX cron semantics.
+ */
+export type FlowTrigger = {
+    readonly id: string;
+    readonly kind: 'manual';
+} | {
+    readonly id: string;
+    readonly kind: 'schedule';
+    readonly cron: string;
+    readonly timezone?: string;
+} | {
+    readonly id: string;
+    readonly kind: 'event';
+    readonly capability: FlowProviderCapabilityRef;
+    readonly event: string;
+} | {
+    readonly id: string;
+    readonly kind: 'webhook';
+    readonly path: string;
+};
+/** An immutable revision of a portable workflow graph. */
+export interface FlowDefinition {
+    readonly id: FlowId;
+    readonly version: number;
+    readonly title: string;
+    readonly description?: string;
+    readonly nodes: readonly FlowNode[];
+    readonly edges: readonly FlowEdge[];
+    readonly triggers: readonly FlowTrigger[];
+}
+/** An immutable workflow revision reference. */
+export interface FlowDefinitionRef {
+    readonly id: FlowId;
+    readonly version: number;
+}
+export type FlowExecutionStatus = 'cancelled' | 'failed' | 'pending' | 'running' | 'succeeded' | 'timed_out' | 'waiting_for_approval';
+/** A portable error observation that never carries a host Error object. */
+export interface FlowError {
+    readonly code: string;
+    readonly message: string;
+    readonly retryable: boolean;
+    readonly details?: FlowDataRef;
+}
+/** A redaction-safe trace observation emitted by a run or step. */
+export interface FlowTraceEvent {
+    readonly timestamp: string;
+    readonly level: 'debug' | 'error' | 'info' | 'warn';
+    readonly message: string;
+    readonly attributes?: Readonly<Record<string, DataContractValue>>;
+}
+/*** A durable snapshot of one execution attempt for a graph node.
+ *
+ * `attempt` is a one-based, monotonically increasing number for this run and node. A retry has a
+ * new step snapshot and attempt number; consumers must not overwrite a completed attempt.
+ */
+export interface FlowStepSnapshot {
+    readonly id: FlowStepId;
+    readonly nodeId: FlowNodeId;
+    readonly status: FlowExecutionStatus;
+    readonly attempt: number;
+    readonly startedAt?: string;
+    readonly completedAt?: string;
+    readonly input?: Readonly<Record<FlowPortId, FlowDataRef>>;
+    readonly output?: Readonly<Record<FlowPortId, FlowDataRef>>;
+    readonly error?: FlowError;
+    readonly trace?: readonly FlowTraceEvent[];
+}
+/** A stable reference to one immutable step attempt in a run. */
+export interface FlowStepRef {
+    readonly runId: FlowRunId;
+    readonly id: FlowStepId;
+    readonly nodeId: FlowNodeId;
+    readonly attempt: number;
+}
+/** A reference to the triggering event or request that started a run. */
+export interface FlowRunTrigger {
+    readonly triggerId: string;
+    readonly kind: FlowTrigger['kind'];
+    readonly data?: FlowDataRef;
+}
+/*** A durable snapshot of an execution against one immutable flow revision.
+ *
+ * A run begins `pending`, may move to `running` or `cancelled`, and is terminal once
+ * `cancelled`, `failed`, `succeeded`, or `timed_out`. `waiting_for_approval` pauses an otherwise
+ * running run; resolving its pending approval resumes it or ends it as cancelled or failed.
+ * Consumers must validate these transitions and must retain the referenced definition revision.
+ */
+export interface FlowRunSnapshot {
+    readonly id: FlowRunId;
+    readonly flow: FlowDefinitionRef;
+    readonly status: FlowExecutionStatus;
+    readonly trigger: FlowRunTrigger;
+    readonly createdAt: string;
+    readonly startedAt?: string;
+    readonly completedAt?: string;
+    readonly input?: Readonly<Record<FlowPortId, FlowDataRef>>;
+    readonly output?: Readonly<Record<FlowPortId, FlowDataRef>>;
+    readonly steps: readonly FlowStepSnapshot[];
+    readonly error?: FlowError;
+    readonly trace?: readonly FlowTraceEvent[];
+}
+/** A stable reference to a run against one immutable workflow revision. */
+export interface FlowRunRef {
+    readonly id: FlowRunId;
+    readonly flow: FlowDefinitionRef;
+}
+export type FlowApprovalStatus = 'approved' | 'cancelled' | 'expired' | 'pending' | 'rejected';
+/*** A serializable human-approval request associated with one durable run.
+ *
+ * An approval starts `pending` and transitions exactly once to `approved`, `rejected`, `expired`,
+ * or `cancelled`; those states are terminal. A step approval identifies its exact attempt so a
+ * later retry cannot resolve an earlier request. Consumers validate timestamps and transitions.
+ */
+export interface FlowApprovalRequest {
+    readonly id: string;
+    readonly runId: FlowRunId;
+    readonly step?: FlowStepRef;
+    readonly status: FlowApprovalStatus;
+    readonly requestedAt: string;
+    readonly expiresAt?: string;
+    readonly resolvedAt?: string;
+    readonly requestedBy?: string;
+    readonly resolvedBy?: string;
+    readonly message?: string;
+    readonly context?: FlowDataRef;
+}
+//# sourceMappingURL=flow.d.ts.map

package/dist/flow.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"flow.d.ts","sourceRoot":"","sources":["../src/flow.ts"],"names":[],"mappings":"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"}

package/dist/flow.js ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export {};
2	+ //# sourceMappingURL=flow.js.map

package/dist/flow.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"flow.js","sourceRoot":"","sources":["../src/flow.ts"],"names":[],"mappings":"","sourcesContent":["import type { DataSchemaSlot } from './data/schemas.js';\nimport type { DataContractValue } from './data/values.js';\nimport type { SecretRef } from './secrets.js';\n\nexport type FlowId = string;\nexport type FlowNodeId = string;\nexport type FlowPortId = string;\nexport type FlowEdgeId = string;\nexport type FlowRunId = string;\nexport type FlowStepId = string;\nexport type FlowArtifactId = string;\nexport type FlowProviderCapabilityId = string;\n\n/** A serializable reference to a provider-owned flow capability. */\nexport interface FlowProviderCapabilityRef {\n readonly providerId: string;\n readonly capabilityId: FlowProviderCapabilityId;\n}\n\n/** A persisted artifact reference for data too large or unsuitable for inline graph data. */\nexport interface FlowArtifactRef {\n readonly kind: 'artifact';\n readonly artifactId: FlowArtifactId;\n readonly mediaType?: string;\n readonly byteLength?: number;\n readonly checksum?: string;\n}\n\n/*** A schema-agnostic inline data reference.\n *\n * Inline values are ordinary non-secret data. Consumers must reject a value at a credential\n * configuration position and require a `FlowSecretRef` there; TypeScript cannot prove that\n * invariant after JSON has crossed a trust boundary.\n */\nexport interface FlowInlineDataRef {\n readonly kind: 'inline';\n readonly value: DataContractValue;\n}\n\n/** A schema-agnostic data reference exchanged by node ports, runs, and traces. */\nexport type FlowDataRef = FlowArtifactRef | FlowInlineDataRef;\n\n/*** A secret-store reference that deliberately excludes secret material.\n *\n * @security flow.test.ts#accepts secret references but excludes inline secret material from their contract\n *\n * Credential configuration must use this reference. Flow consumers must validate provider\n * configuration at their boundary, reject inline credentials, and redact secrets from errors and\n * traces. This portable DTO cannot determine which arbitrary provider fields are credentials, so\n * it provides no runtime validation and makes no static guarantee for untyped JSON.\n */\nexport interface FlowSecretRef {\n readonly kind: 'secret';\n readonly ref: SecretRef;\n}\n\n/*** JSON-safe node configuration references.\n *\n * A configuration value is always explicitly either non-secret data or a secret-store reference;\n * raw JSON values are intentionally not accepted. Provider consumers own validation of the\n * declared configuration shape and credential positions before execution.\n */\nexport type FlowNodeConfigValue = FlowDataRef | FlowSecretRef;\nexport type FlowNodeConfig = Readonly<Record<string, FlowNodeConfigValue>>;\n\n/** A typed node port. Direction determines whether a node consumes or produces the port value. */\nexport interface FlowPortDescriptor {\n readonly id: FlowPortId;\n readonly direction: 'input' | 'output';\n readonly label?: string;\n readonly description?: string;\n readonly required?: boolean;\n readonly data?: DataSchemaSlot;\n}\n\n/** One provider-backed executable step within a portable flow graph. */\nexport interface FlowNode {\n readonly id: FlowNodeId;\n readonly capability: FlowProviderCapabilityRef;\n readonly label?: string;\n readonly config?: FlowNodeConfig;\n readonly ports: readonly FlowPortDescriptor[];\n}\n\n/*** A condition declared on an edge without embedding executable expressions.\n *\n * A `value` condition evaluates `path` as an RFC 6901 JSON Pointer against the source port's\n * JSON value; the empty string denotes the complete value. Missing-pointer evaluation does not\n * match. `equals` uses JSON structural equality: values have the same type and recursive array\n * order and object member/value pairs, independent of object member order. Engines must not use\n * coercion, locale comparison, or executable expressions.\n */\nexport type FlowEdgeCondition =\n | { readonly kind: 'always' }\n | { readonly kind: 'outcome'; readonly outcome: 'failure' | 'success' }\n | { readonly kind: 'value'; readonly path: string; readonly equals: DataContractValue };\n\n/** A directed connection from one output port to one input port. */\nexport interface FlowEdge {\n readonly id: FlowEdgeId;\n readonly source: { readonly nodeId: FlowNodeId; readonly portId: FlowPortId };\n readonly target: { readonly nodeId: FlowNodeId; readonly portId: FlowPortId };\n readonly condition?: FlowEdgeCondition;\n}\n\n/*** A portable trigger declaration; runtime scheduling and delivery remain provider-owned.\n *\n * A schedule uses a five-field POSIX cron expression: minute, hour, day of month, month, and day\n * of week. Seconds, years, macros, and implementation-specific extensions are invalid. `timezone`\n * is an IANA time-zone name and defaults to `Etc/UTC`. Match it against local wall-clock time; a\n * spring-forward nonexistent local time is skipped and each occurrence of a repeated local time\n * during a fall-back transition fires separately. When both day-of-month and day-of-week are\n * restricted, either match is sufficient, following POSIX cron semantics.\n */\nexport type FlowTrigger =\n | { readonly id: string; readonly kind: 'manual' }\n | {\n readonly id: string;\n readonly kind: 'schedule';\n readonly cron: string;\n readonly timezone?: string;\n }\n | {\n readonly id: string;\n readonly kind: 'event';\n readonly capability: FlowProviderCapabilityRef;\n readonly event: string;\n }\n | { readonly id: string; readonly kind: 'webhook'; readonly path: string };\n\n/** An immutable revision of a portable workflow graph. */\nexport interface FlowDefinition {\n readonly id: FlowId;\n readonly version: number;\n readonly title: string;\n readonly description?: string;\n readonly nodes: readonly FlowNode[];\n readonly edges: readonly FlowEdge[];\n readonly triggers: readonly FlowTrigger[];\n}\n\n/** An immutable workflow revision reference. */\nexport interface FlowDefinitionRef {\n readonly id: FlowId;\n readonly version: number;\n}\n\nexport type FlowExecutionStatus =\n | 'cancelled'\n | 'failed'\n | 'pending'\n | 'running'\n | 'succeeded'\n | 'timed_out'\n | 'waiting_for_approval';\n\n/** A portable error observation that never carries a host Error object. */\nexport interface FlowError {\n readonly code: string;\n readonly message: string;\n readonly retryable: boolean;\n readonly details?: FlowDataRef;\n}\n\n/** A redaction-safe trace observation emitted by a run or step. */\nexport interface FlowTraceEvent {\n readonly timestamp: string;\n readonly level: 'debug' | 'error' | 'info' | 'warn';\n readonly message: string;\n readonly attributes?: Readonly<Record<string, DataContractValue>>;\n}\n\n/*** A durable snapshot of one execution attempt for a graph node.\n *\n * `attempt` is a one-based, monotonically increasing number for this run and node. A retry has a\n * new step snapshot and attempt number; consumers must not overwrite a completed attempt.\n */\nexport interface FlowStepSnapshot {\n readonly id: FlowStepId;\n readonly nodeId: FlowNodeId;\n readonly status: FlowExecutionStatus;\n readonly attempt: number;\n readonly startedAt?: string;\n readonly completedAt?: string;\n readonly input?: Readonly<Record<FlowPortId, FlowDataRef>>;\n readonly output?: Readonly<Record<FlowPortId, FlowDataRef>>;\n readonly error?: FlowError;\n readonly trace?: readonly FlowTraceEvent[];\n}\n\n/** A stable reference to one immutable step attempt in a run. */\nexport interface FlowStepRef {\n readonly runId: FlowRunId;\n readonly id: FlowStepId;\n readonly nodeId: FlowNodeId;\n readonly attempt: number;\n}\n\n/** A reference to the triggering event or request that started a run. */\nexport interface FlowRunTrigger {\n readonly triggerId: string;\n readonly kind: FlowTrigger['kind'];\n readonly data?: FlowDataRef;\n}\n\n/*** A durable snapshot of an execution against one immutable flow revision.\n *\n * A run begins `pending`, may move to `running` or `cancelled`, and is terminal once\n * `cancelled`, `failed`, `succeeded`, or `timed_out`. `waiting_for_approval` pauses an otherwise\n * running run; resolving its pending approval resumes it or ends it as cancelled or failed.\n * Consumers must validate these transitions and must retain the referenced definition revision.\n */\nexport interface FlowRunSnapshot {\n readonly id: FlowRunId;\n readonly flow: FlowDefinitionRef;\n readonly status: FlowExecutionStatus;\n readonly trigger: FlowRunTrigger;\n readonly createdAt: string;\n readonly startedAt?: string;\n readonly completedAt?: string;\n readonly input?: Readonly<Record<FlowPortId, FlowDataRef>>;\n readonly output?: Readonly<Record<FlowPortId, FlowDataRef>>;\n readonly steps: readonly FlowStepSnapshot[];\n readonly error?: FlowError;\n readonly trace?: readonly FlowTraceEvent[];\n}\n\n/** A stable reference to a run against one immutable workflow revision. */\nexport interface FlowRunRef {\n readonly id: FlowRunId;\n readonly flow: FlowDefinitionRef;\n}\n\nexport type FlowApprovalStatus = 'approved' | 'cancelled' | 'expired' | 'pending' | 'rejected';\n\n/*** A serializable human-approval request associated with one durable run.\n *\n * An approval starts `pending` and transitions exactly once to `approved`, `rejected`, `expired`,\n * or `cancelled`; those states are terminal. A step approval identifies its exact attempt so a\n * later retry cannot resolve an earlier request. Consumers validate timestamps and transitions.\n */\nexport interface FlowApprovalRequest {\n readonly id: string;\n readonly runId: FlowRunId;\n readonly step?: FlowStepRef;\n readonly status: FlowApprovalStatus;\n readonly requestedAt: string;\n readonly expiresAt?: string;\n readonly resolvedAt?: string;\n readonly requestedBy?: string;\n readonly resolvedBy?: string;\n readonly message?: string;\n readonly context?: FlowDataRef;\n}\n"]}

package/dist/index.d.ts CHANGED Viewed

@@ -9,6 +9,7 @@ export * from './db.js';
 export * from './deploy.js';
 export * from './deployProvider.js';
 export * from './environments.js';
+export * from './flow.js';
 export * from './infra.js';
 export * from './media.js';
 export * from './navigator.js';

package/dist/index.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC"}
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC"}

package/dist/index.js CHANGED Viewed

@@ -9,6 +9,7 @@ export * from './db.js';
 export * from './deploy.js';
 export * from './deployProvider.js';
 export * from './environments.js';
+export * from './flow.js';
 export * from './infra.js';
 export * from './media.js';
 export * from './navigator.js';

package/dist/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC","sourcesContent":["export * from './ads.js';\nexport * from './appManifest.js';\nexport * from './auth.js';\nexport * from './bindings.js';\nexport * from './cli/index.js';\nexport * from './collections.js';\nexport * from './data/index.js';\nexport * from './db.js';\nexport * from './deploy.js';\nexport * from './deployProvider.js';\nexport * from './environments.js';\nexport * from './infra.js';\nexport * from './media.js';\nexport * from './navigator.js';\nexport * from './repository.js';\nexport * from './requirements.js';\nexport * from './rules.js';\nexport * from './runtimeCallbacks.js';\nexport * from './secrets.js';\nexport * from './serializable.js';\nexport * from './state.js';\nexport * from './storage.js';\nexport * from './structure/index.js';\nexport * from './theme.js';\nexport * from './types.js';\nexport * from './ui.js';\nexport * from './website.js';\n"]}
1	+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC","sourcesContent":["export * from './ads.js';\nexport * from './appManifest.js';\nexport * from './auth.js';\nexport * from './bindings.js';\nexport * from './cli/index.js';\nexport * from './collections.js';\nexport * from './data/index.js';\nexport * from './db.js';\nexport * from './deploy.js';\nexport * from './deployProvider.js';\nexport * from './environments.js';\nexport * from './flow.js';\nexport * from './infra.js';\nexport * from './media.js';\nexport * from './navigator.js';\nexport * from './repository.js';\nexport * from './requirements.js';\nexport * from './rules.js';\nexport * from './runtimeCallbacks.js';\nexport * from './secrets.js';\nexport * from './serializable.js';\nexport * from './state.js';\nexport * from './storage.js';\nexport * from './structure/index.js';\nexport * from './theme.js';\nexport * from './types.js';\nexport * from './ui.js';\nexport * from './website.js';\n"]}

package/dist/structure/generated.d.ts CHANGED Viewed

@@ -1,9 +1,9 @@
 export declare const STRUCTURE_DESCRIPTOR_COMPILER_VERSION = "6.0.3";
-export declare const STRUCTURE_DESCRIPTOR_FINGERPRINT = "sha256:dd8057c752c877b62bdc5c8db41135bd76c55dedf9bf4e1a13d7bf977f9cca56";
+export declare const STRUCTURE_DESCRIPTOR_FINGERPRINT = "sha256:67f55755ba8bc7a6ba9239317adbad41d62c006976654188a9f817e3c807509a";
 export declare const STRUCTURE_DESCRIPTOR: {
     readonly protocolVersion: 1;
     readonly packageName: "@ankhorage/contracts";
-    readonly packageVersion: "26.6.0";
+    readonly packageVersion: "26.7.0";
     readonly roots: {
         readonly "auth-flow": "AuthFlowConfig";
         readonly "auth-profile": "AuthProfileSpec";

package/dist/structure/generated.js CHANGED Viewed

@@ -1,9 +1,9 @@
 export const STRUCTURE_DESCRIPTOR_COMPILER_VERSION = '6.0.3';
-export const STRUCTURE_DESCRIPTOR_FINGERPRINT = 'sha256:dd8057c752c877b62bdc5c8db41135bd76c55dedf9bf4e1a13d7bf977f9cca56';
+export const STRUCTURE_DESCRIPTOR_FINGERPRINT = 'sha256:67f55755ba8bc7a6ba9239317adbad41d62c006976654188a9f817e3c807509a';
 export const STRUCTURE_DESCRIPTOR = {
     "protocolVersion": 1,
     "packageName": "@ankhorage/contracts",
-    "packageVersion": "26.6.0",
+    "packageVersion": "26.7.0",
     "roots": {
         "auth-flow": "AuthFlowConfig",
         "auth-profile": "AuthProfileSpec",

package/dist/structure/generated.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"generated.js","sourceRoot":"","sources":["../../src/structure/generated.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,qCAAqC,GAAG,OAAO,CAAC;AAC7D,MAAM,CAAC,MAAM,gCAAgC,GAAG,yEAAyE,CAAC;AAE1H,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,iBAAiB,EAAE,CAAC;IACpB,aAAa,EAAE,sBAAsB;IACrC,gBAAgB,EAAE,QAAQ;IAC1B,OAAO,EAAE;QACP,WAAW,EAAE,gBAAgB;QAC7B,cAAc,EAAE,iBAAiB;QACjC,cAAc,EAAE,gBAAgB;QAChC,cAAc,EAAE,gBAAgB;QAChC,iBAAiB,EAAE,oBAAoB;QACvC,qBAAqB,EAAE,oBAAoB;QAC3C,cAAc,EAAE,aAAa;KAC9B;IACD,aAAa,EAAE;QACb,gBAAgB,EAAE;YAChB,IAAI,EAAE,gBAAgB;YACtB,YAAY,EAAE;gBACZ,MAAM,EAAE,QAAQ;gBAChB,QAAQ,EAAE;oBACR,qBAAqB,EAAE;wBACrB,OAAO,EAAE;4BACP,MAAM,EAAE,QAAQ;4BAChB,MAAM,EAAE,QAAQ;yBACjB;wBACD,UAAU,EAAE,IAAI;qBACjB;oBACD,UAAU,EAAE;wBACV,OAAO,EAAE;4BACP,MAAM,EAAE,QAAQ;4BAChB,MAAM,EAAE,QAAQ;yBACjB;wBACD,UAAU,EAAE,IAAI;qBACjB;oBACD,iBAAiB,EAAE;wBACjB,OAAO,EAAE;4BACP,MAAM,EAAE,QAAQ;4BAChB,MAAM,EAAE,QAAQ;yBACjB;qBACF;oBACD,aAAa,EAAE;wBACb,OAAO,EAAE;4BACP,MAAM,EAAE,QAAQ;4BAChB,MAAM,EAAE,QAAQ;yBACjB;qBACF;oBACD,cAAc,EAAE;wBACd,OAAO,EAAE;4BACP,MAAM,EAAE,QAAQ;4BAChB,MAAM,EAAE,QAAQ;yBACjB;wBACD,UAAU,EAAE,IAAI;qBACjB;oBACD,aAAa,EAAE;wBACb,OAAO,EAAE;4BACP,MAAM,EAAE,QAAQ;4BAChB,MAAM,EAAE,QAAQ;yBACjB;wBACD,UAAU,EAAE,IAAI;qBACjB;oBACD,mBAAmB,EAAE;wBACnB,OAAO,EAAE;4BACP,MAAM,EAAE,QAAQ;4BAChB,MAAM,EAAE,QAAQ;yBACjB;wBACD,UAAU,EAAE,IAAI;qBACjB;iBACF;aACF;SACF;QACD,kBAAkB,EAAE;YAClB,IAAI,EAAE,kBAAkB;YACxB,YAAY,EAAE;gBACZ,MAAM,EAAE,QAAQ;gBAChB,MAAM,EAAE,QAAQ;aACjB;SACF;QACD,iBAAiB,EAAE;YACjB,IAAI,EAAE,iBAAiB;YACvB,YAAY,EAAE;gBACZ,MAAM,EAAE,QAAQ;gBAChB,QAAQ,EAAE;oBACR,gBAAgB,EAAE;wBAChB,OAAO,EAAE;4BACP,MAAM,EAAE,MAAM;4BACd,QAAQ,EAAE;gCACR,KAAK;gCACL,KAAK;gCACL,SAAS;6BACV;yBACF;wBACD,UAAU,EAAE,IAAI;qBACjB;oBACD,QAAQ,EAAE;wBACR,OAAO,EAAE;4BACP,MAAM,EAAE,cAAc;4BACtB,MAAM,EAAE;gCACN,MAAM,EAAE,KAAK;gCACb,IAAI,EAAE,kBAAkB;6BACzB;yBACF;qBACF;oBACD,YAAY,EAAE;wBACZ,OAAO,EAAE;4BACP,MAAM,EAAE,MAAM;4BACd,QAAQ,EAAE;gCACR,YAAY;6BACb;yBACF;wBACD,UAAU,EAAE,IAAI;qBACjB;oBACD,OAAO,EAAE;wBACP,OAAO,EAAE;4BACP,MAAM,EAAE,QAAQ;4BAChB,MAAM,EAAE,QAAQ;yBACjB;wBACD,UAAU,EAAE,IAAI;qBACjB;oBACD,gBAAgB,EAAE;wBAChB,OAAO,EAAE;4BACP,MAAM,EAAE,MAAM;4BACd,QAAQ,EAAE;gCACR,KAAK;gCACL,KAAK;6BACN;yBACF;wBACD,UAAU,EAAE,IAAI;qBACjB;iBACF;aACF;SACF;QACD,gBAAgB,EAAE;YAChB,IAAI,EAAE,gBAAgB;YACtB,YAAY,EAAE;gBACZ,MAAM,EAAE,QAAQ;gBAChB,QAAQ,EAAE;oBACR,aAAa,EAAE;wBACb,OAAO,EAAE;4BACP,MAAM,EAAE,cAAc;4BACtB,MAAM,EAAE;gCACN,MAAM,EAAE,MAAM;gCACd,QAAQ,EAAE;oCACR,OAAO;oCACP,OAAO;oCACP,UAAU;iCACX;6BACF;yBACF;qBACF;iBACF;aACF;SACF;QACD,iBAAiB,EAAE;YACjB,IAAI,EAAE,iBAAiB;YACvB,YAAY,EAAE;gBACZ,MAAM,EAAE,QAAQ;gBAChB,MAAM,EAAE,QAAQ;aACjB;SACF;QACD,gBAAgB,EAAE;YAChB,IAAI,EAAE,gBAAgB;YACtB,YAAY,EAAE;gBACZ,MAAM,EAAE,QAAQ;gBAChB,QAAQ,EAAE;oBACR,gBAAgB,EAAE;wBAChB,OAAO,EAAE;4BACP,MAAM,EAAE,cAAc;4BACtB,MAAM,EAAE;gCACN,MAAM,EAAE,KAAK;gCACb,IAAI,EAAE,iBAAiB;6BACxB;yBACF;wBACD,UAAU,EAAE,IAAI;qBACjB;oBACD,gBAAgB,EAAE;wBAChB,OAAO,EAAE;4BACP,MAAM,EAAE,cAAc;4BACtB,MAAM,EAAE;gCACN,MAAM,EAAE,KAAK;gCACb,IAAI,EAAE,iBAAiB;6BACxB;yBACF;qBACF;oBACD,cAAc,EAAE;wBACd,OAAO,EAAE;4BACP,MAAM,EAAE,MAAM;4BACd,QAAQ,EAAE;gCACR,YAAY;gCACZ,qBAAqB;6BACtB;yBACF;wBACD,UAAU,EAAE,IAAI;qBACjB;iBACF;aACF;SACF;QACD,oBAAoB,EAAE;YACpB,IAAI,EAAE,oBAAoB;YAC1B,YAAY,EAAE;gBACZ,MAAM,EAAE,QAAQ;gBAChB,QAAQ,EAAE;oBACR,aAAa,EAAE;wBACb,OAAO,EAAE;4BACP,MAAM,EAAE,QAAQ;4BAChB,MAAM,EAAE,QAAQ;yBACjB;wBACD,UAAU,EAAE,IAAI;qBACjB;oBACD,IAAI,EAAE;wBACJ,OAAO,EAAE;4BACP,MAAM,EAAE,QAAQ;4BAChB,MAAM,EAAE,QAAQ;yBACjB;qBACF;oBACD,MAAM,EAAE;wBACN,OAAO,EAAE;4BACP,MAAM,EAAE,QAAQ;4BAChB,MAAM,EAAE,QAAQ;yBACjB;qBACF;oBACD,OAAO,EAAE;wBACP,OAAO,EAAE;4BACP,MAAM,EAAE,QAAQ;4BAChB,MAAM,EAAE,QAAQ;yBACjB;wBACD,UAAU,EAAE,IAAI;qBACjB;iBACF;aACF;SACF;QACD,oBAAoB,EAAE;YACpB,IAAI,EAAE,oBAAoB;YAC1B,YAAY,EAAE;gBACZ,MAAM,EAAE,QAAQ;gBAChB,QAAQ,EAAE;oBACR,cAAc,EAAE;wBACd,OAAO,EAAE;4BACP,MAAM,EAAE,KAAK;4BACb,QAAQ,EAAE;gCACR,MAAM,EAAE,MAAM;gCACd,QAAQ,EAAE;oCACR,gBAAgB;oCAChB,eAAe;oCACf,WAAW;oCACX,aAAa;oCACb,YAAY;oCACZ,UAAU;oCACV,aAAa;oCACb,eAAe;iCAChB;6BACF;yBACF;wBACD,UAAU,EAAE,IAAI;qBACjB;oBACD,aAAa,EAAE;wBACb,OAAO,EAAE;4BACP,MAAM,EAAE,KAAK;4BACb,QAAQ,EAAE;gCACR,MAAM,EAAE,MAAM;gCACd,QAAQ,EAAE;oCACR,QAAQ;oCACR,WAAW;oCACX,oBAAoB;oCACpB,oBAAoB;oCACpB,cAAc;oCACd,mBAAmB;oCACnB,YAAY;oCACZ,eAAe;iCAChB;6BACF;yBACF;wBACD,UAAU,EAAE,IAAI;qBACjB;iBACF;aACF;SACF;QACD,aAAa,EAAE;YACb,IAAI,EAAE,aAAa;YACnB,YAAY,EAAE;gBACZ,MAAM,EAAE,QAAQ;gBAChB,QAAQ,EAAE;oBACR,MAAM,EAAE;wBACN,OAAO,EAAE;4BACP,MAAM,EAAE,KAAK;4BACb,IAAI,EAAE,iBAAiB;yBACxB;qBACF;oBACD,IAAI,EAAE;wBACJ,OAAO,EAAE;4BACP,MAAM,EAAE,QAAQ;4BAChB,MAAM,EAAE,QAAQ;yBACjB;qBACF;oBACD,OAAO,EAAE;wBACP,OAAO,EAAE;4BACP,MAAM,EAAE,KAAK;4BACb,IAAI,EAAE,iBAAiB;yBACxB;qBACF;oBACD,MAAM,EAAE;wBACN,OAAO,EAAE;4BACP,MAAM,EAAE,QAAQ;4BAChB,MAAM,EAAE,QAAQ;yBACjB;qBACF;oBACD,SAAS,EAAE;wBACT,OAAO,EAAE;4BACP,MAAM,EAAE,KAAK;4BACb,IAAI,EAAE,sBAAsB;yBAC7B;wBACD,UAAU,EAAE,IAAI;qBACjB;oBACD,QAAQ,EAAE;wBACR,OAAO,EAAE;4BACP,MAAM,EAAE,KAAK;4BACb,IAAI,EAAE,2BAA2B;yBAClC;wBACD,UAAU,EAAE,IAAI;qBACjB;iBACF;aACF;SACF;QACD,2BAA2B,EAAE;YAC3B,IAAI,EAAE,2BAA2B;YACjC,YAAY,EAAE;gBACZ,MAAM,EAAE,QAAQ;gBAChB,QAAQ,EAAE;oBACR,OAAO,EAAE;wBACP,OAAO,EAAE;4BACP,MAAM,EAAE,WAAW;4BACnB,KAAK,EAAE;gCACL,MAAM,EAAE,QAAQ;gCAChB,MAAM,EAAE,QAAQ;6BACjB;4BACD,OAAO,EAAE;gCACP,MAAM,EAAE,QAAQ;gCAChB,MAAM,EAAE,QAAQ;6BACjB;yBACF;wBACD,UAAU,EAAE,IAAI;qBACjB;oBACD,SAAS,EAAE;wBACT,OAAO,EAAE;4BACP,MAAM,EAAE,WAAW;4BACnB,KAAK,EAAE;gCACL,MAAM,EAAE,QAAQ;gCAChB,MAAM,EAAE,QAAQ;6BACjB;4BACD,OAAO,EAAE;gCACP,MAAM,EAAE,QAAQ;gCAChB,MAAM,EAAE,QAAQ;6BACjB;yBACF;wBACD,UAAU,EAAE,IAAI;qBACjB;oBACD,SAAS,EAAE;wBACT,OAAO,EAAE;4BACP,MAAM,EAAE,WAAW;4BACnB,KAAK,EAAE;gCACL,MAAM,EAAE,QAAQ;gCAChB,MAAM,EAAE,QAAQ;6BACjB;4BACD,OAAO,EAAE;gCACP,MAAM,EAAE,QAAQ;gCAChB,MAAM,EAAE,QAAQ;6BACjB;yBACF;wBACD,UAAU,EAAE,IAAI;qBACjB;oBACD,YAAY,EAAE;wBACZ,OAAO,EAAE;4BACP,MAAM,EAAE,KAAK;4BACb,IAAI,EAAE,+BAA+B;yBACtC;wBACD,UAAU,EAAE,IAAI;qBACjB;iBACF;aACF;SACF;QACD,iBAAiB,EAAE;YACjB,IAAI,EAAE,iBAAiB;YACvB,YAAY,EAAE;gBACZ,MAAM,EAAE,QAAQ;gBAChB,QAAQ,EAAE;oBACR,SAAS,EAAE;wBACT,OAAO,EAAE;4BACP,MAAM,EAAE,MAAM;4BACd,QAAQ,EAAE;gCACR,WAAW;gCACX,eAAe;gCACf,eAAe;gCACf,oBAAoB;gCACpB,QAAQ;gCACR,UAAU;gCACV,SAAS;6BACV;yBACF;qBACF;oBACD,cAAc,EAAE;wBACd,OAAO,EAAE;4BACP,MAAM,EAAE,QAAQ;4BAChB,MAAM,EAAE,QAAQ;yBACjB;qBACF;iBACF;aACF;SACF;QACD,sBAAsB,EAAE;YACtB,IAAI,EAAE,sBAAsB;YAC5B,YAAY,EAAE;gBACZ,MAAM,EAAE,QAAQ;gBAChB,QAAQ,EAAE;oBACR,YAAY,EAAE;wBACZ,OAAO,EAAE;4BACP,MAAM,EAAE,WAAW;4BACnB,KAAK,EAAE;gCACL,MAAM,EAAE,QAAQ;gCAChB,MAAM,EAAE,QAAQ;6BACjB;4BACD,OAAO,EAAE;gCACP,MAAM,EAAE,KAAK;gCACb,aAAa,EAAE,YAAY;gCAC3B,IAAI,EAAE,UAAU;6BACjB;yBACF;wBACD,UAAU,EAAE,IAAI;qBACjB;oBACD,UAAU,EAAE;wBACV,OAAO,EAAE;4BACP,MAAM,EAAE,WAAW;4BACnB,KAAK,EAAE;gCACL,MAAM,EAAE,QAAQ;gCAChB,MAAM,EAAE,QAAQ;6BACjB;4BACD,OAAO,EAAE;gCACP,MAAM,EAAE,KAAK;gCACb,aAAa,EAAE,YAAY;gCAC3B,IAAI,EAAE,UAAU;6BACjB;yBACF;wBACD,UAAU,EAAE,IAAI;qBACjB;iBACF;aACF;SACF;QACD,iCAAiC,EAAE;YACjC,IAAI,EAAE,iCAAiC;YACvC,YAAY,EAAE;gBACZ,MAAM,EAAE,QAAQ;gBAChB,QAAQ,EAAE;oBACR,YAAY,EAAE;wBACZ,OAAO,EAAE;4BACP,MAAM,EAAE,QAAQ;4BAChB,MAAM,EAAE,QAAQ;yBACjB;wBACD,UAAU,EAAE,IAAI;qBACjB;oBACD,MAAM,EAAE;wBACN,OAAO,EAAE;4BACP,MAAM,EAAE,QAAQ;4BAChB,MAAM,EAAE,QAAQ;yBACjB;wBACD,UAAU,EAAE,IAAI;qBACjB;oBACD,QAAQ,EAAE;wBACR,OAAO,EAAE;4BACP,MAAM,EAAE,QAAQ;4BAChB,MAAM,EAAE,QAAQ;yBACjB;wBACD,UAAU,EAAE,IAAI;qBACjB;iBACF;aACF;SACF;QACD,+BAA+B,EAAE;YAC/B,IAAI,EAAE,+BAA+B;YACrC,YAAY,EAAE;gBACZ,MAAM,EAAE,QAAQ;gBAChB,QAAQ,EAAE;oBACR,UAAU,EAAE;wBACV,OAAO,EAAE;4BACP,MAAM,EAAE,WAAW;4BACnB,KAAK,EAAE;gCACL,MAAM,EAAE,QAAQ;gCAChB,MAAM,EAAE,QAAQ;6BACjB;4BACD,OAAO,EAAE;gCACP,MAAM,EAAE,KAAK;gCACb,IAAI,EAAE,iCAAiC;6BACxC;yBACF;wBACD,UAAU,EAAE,IAAI;qBACjB;oBACD,OAAO,EAAE;wBACP,OAAO,EAAE;4BACP,MAAM,EAAE,WAAW;4BACnB,KAAK,EAAE;gCACL,MAAM,EAAE,QAAQ;gCAChB,MAAM,EAAE,QAAQ;6BACjB;4BACD,OAAO,EAAE;gCACP,MAAM,EAAE,QAAQ;gCAChB,MAAM,EAAE,QAAQ;6BACjB;yBACF;wBACD,UAAU,EAAE,IAAI;qBACjB;oBACD,SAAS,EAAE;wBACT,OAAO,EAAE;4BACP,MAAM,EAAE,WAAW;4BACnB,KAAK,EAAE;gCACL,MAAM,EAAE,QAAQ;gCAChB,MAAM,EAAE,QAAQ;6BACjB;4BACD,OAAO,EAAE;gCACP,MAAM,EAAE,QAAQ;gCAChB,MAAM,EAAE,QAAQ;6BACjB;yBACF;wBACD,UAAU,EAAE,IAAI;qBACjB;iBACF;aACF;SACF;KACF;CAC6C,CAAC","sourcesContent":["/* This file is generated by @ankhorage/devtools. Do not edit manually. */\nimport type { StructureDescriptorDocument } from '@ankhorage/contracts/structure';\n\nexport const STRUCTURE_DESCRIPTOR_COMPILER_VERSION = '6.0.3';\nexport const STRUCTURE_DESCRIPTOR_FINGERPRINT = 'sha256:dd8057c752c877b62bdc5c8db41135bd76c55dedf9bf4e1a13d7bf977f9cca56';\n\nexport const STRUCTURE_DESCRIPTOR = {\n \"protocolVersion\": 1,\n \"packageName\": \"@ankhorage/contracts\",\n \"packageVersion\": \"26.6.0\",\n \"roots\": {\n \"auth-flow\": \"AuthFlowConfig\",\n \"auth-profile\": \"AuthProfileSpec\",\n \"auth-sign-in\": \"AuthSignInSpec\",\n \"auth-sign-up\": \"AuthSignUpSpec\",\n \"screen-metadata\": \"ScreenMetadataSpec\",\n \"screen-requirements\": \"ScreenRequirements\",\n \"theme-config\": \"ThemeConfig\"\n },\n \"descriptors\": {\n \"AuthFlowConfig\": {\n \"id\": \"AuthFlowConfig\",\n \"descriptor\": {\n \"kind\": \"object\",\n \"fields\": {\n \"forgotPasswordRoute\": {\n \"value\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n },\n \"optional\": true\n },\n \"otpRoute\": {\n \"value\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n },\n \"optional\": true\n },\n \"postSignInRoute\": {\n \"value\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n }\n },\n \"signInRoute\": {\n \"value\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n }\n },\n \"signOutRoute\": {\n \"value\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n },\n \"optional\": true\n },\n \"signUpRoute\": {\n \"value\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n },\n \"optional\": true\n },\n \"unauthorizedRoute\": {\n \"value\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n },\n \"optional\": true\n }\n }\n }\n },\n \"AuthProfileField\": {\n \"id\": \"AuthProfileField\",\n \"descriptor\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n }\n },\n \"AuthProfileSpec\": {\n \"id\": \"AuthProfileSpec\",\n \"descriptor\": {\n \"kind\": \"object\",\n \"fields\": {\n \"createStrategy\": {\n \"value\": {\n \"kind\": \"enum\",\n \"values\": [\n \"api\",\n \"app\",\n \"trigger\"\n ]\n },\n \"optional\": true\n },\n \"fields\": {\n \"value\": {\n \"kind\": \"ordered-list\",\n \"item\": {\n \"kind\": \"ref\",\n \"id\": \"AuthProfileField\"\n }\n }\n },\n \"primaryKey\": {\n \"value\": {\n \"kind\": \"enum\",\n \"values\": [\n \"authUserId\"\n ]\n },\n \"optional\": true\n },\n \"table\": {\n \"value\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n },\n \"optional\": true\n },\n \"updateStrategy\": {\n \"value\": {\n \"kind\": \"enum\",\n \"values\": [\n \"api\",\n \"app\"\n ]\n },\n \"optional\": true\n }\n }\n }\n },\n \"AuthSignInSpec\": {\n \"id\": \"AuthSignInSpec\",\n \"descriptor\": {\n \"kind\": \"object\",\n \"fields\": {\n \"identifiers\": {\n \"value\": {\n \"kind\": \"ordered-list\",\n \"item\": {\n \"kind\": \"enum\",\n \"values\": [\n \"email\",\n \"phone\",\n \"username\"\n ]\n }\n }\n }\n }\n }\n },\n \"AuthSignUpField\": {\n \"id\": \"AuthSignUpField\",\n \"descriptor\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n }\n },\n \"AuthSignUpSpec\": {\n \"id\": \"AuthSignUpSpec\",\n \"descriptor\": {\n \"kind\": \"object\",\n \"fields\": {\n \"optionalFields\": {\n \"value\": {\n \"kind\": \"ordered-list\",\n \"item\": {\n \"kind\": \"ref\",\n \"id\": \"AuthSignUpField\"\n }\n },\n \"optional\": true\n },\n \"requiredFields\": {\n \"value\": {\n \"kind\": \"ordered-list\",\n \"item\": {\n \"kind\": \"ref\",\n \"id\": \"AuthSignUpField\"\n }\n }\n },\n \"signUpPolicy\": {\n \"value\": {\n \"kind\": \"enum\",\n \"values\": [\n \"autoSignIn\",\n \"requireVerification\"\n ]\n },\n \"optional\": true\n }\n }\n }\n },\n \"ScreenMetadataSpec\": {\n \"id\": \"ScreenMetadataSpec\",\n \"descriptor\": {\n \"kind\": \"object\",\n \"fields\": {\n \"description\": {\n \"value\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n },\n \"optional\": true\n },\n \"id\": {\n \"value\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n }\n },\n \"name\": {\n \"value\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n }\n },\n \"title\": {\n \"value\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n },\n \"optional\": true\n }\n }\n }\n },\n \"ScreenRequirements\": {\n \"id\": \"ScreenRequirements\",\n \"descriptor\": {\n \"kind\": \"object\",\n \"fields\": {\n \"capabilities\": {\n \"value\": {\n \"kind\": \"set\",\n \"member\": {\n \"kind\": \"enum\",\n \"values\": [\n \"barcodeScanner\",\n \"cameraPreview\",\n \"clipboard\",\n \"ebookReader\",\n \"filePicker\",\n \"location\",\n \"mediaPicker\",\n \"notifications\"\n ]\n }\n },\n \"optional\": true\n },\n \"permissions\": {\n \"value\": {\n \"kind\": \"set\",\n \"member\": {\n \"kind\": \"enum\",\n \"values\": [\n \"camera\",\n \"clipboard\",\n \"locationBackground\",\n \"locationForeground\",\n \"mediaLibrary\",\n \"mediaLibraryWrite\",\n \"microphone\",\n \"notifications\"\n ]\n }\n },\n \"optional\": true\n }\n }\n }\n },\n \"ThemeConfig\": {\n \"id\": \"ThemeConfig\",\n \"descriptor\": {\n \"kind\": \"object\",\n \"fields\": {\n \"dark\": {\n \"value\": {\n \"kind\": \"ref\",\n \"id\": \"ThemeModeConfig\"\n }\n },\n \"id\": {\n \"value\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n }\n },\n \"light\": {\n \"value\": {\n \"kind\": \"ref\",\n \"id\": \"ThemeModeConfig\"\n }\n },\n \"name\": {\n \"value\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n }\n },\n \"recipes\": {\n \"value\": {\n \"kind\": \"ref\",\n \"id\": \"ThemeRecipeOverrides\"\n },\n \"optional\": true\n },\n \"tokens\": {\n \"value\": {\n \"kind\": \"ref\",\n \"id\": \"ThemeGlobalTokenOverrides\"\n },\n \"optional\": true\n }\n }\n }\n },\n \"ThemeGlobalTokenOverrides\": {\n \"id\": \"ThemeGlobalTokenOverrides\",\n \"descriptor\": {\n \"kind\": \"object\",\n \"fields\": {\n \"radii\": {\n \"value\": {\n \"kind\": \"value-map\",\n \"key\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n },\n \"value\": {\n \"kind\": \"scalar\",\n \"type\": \"number\"\n }\n },\n \"optional\": true\n },\n \"shadows\": {\n \"value\": {\n \"kind\": \"value-map\",\n \"key\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n },\n \"value\": {\n \"kind\": \"scalar\",\n \"type\": \"number\"\n }\n },\n \"optional\": true\n },\n \"spacing\": {\n \"value\": {\n \"kind\": \"value-map\",\n \"key\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n },\n \"value\": {\n \"kind\": \"scalar\",\n \"type\": \"number\"\n }\n },\n \"optional\": true\n },\n \"typography\": {\n \"value\": {\n \"kind\": \"ref\",\n \"id\": \"ThemeTypographyTokenOverrides\"\n },\n \"optional\": true\n }\n }\n }\n },\n \"ThemeModeConfig\": {\n \"id\": \"ThemeModeConfig\",\n \"descriptor\": {\n \"kind\": \"object\",\n \"fields\": {\n \"harmony\": {\n \"value\": {\n \"kind\": \"enum\",\n \"values\": [\n \"analogous\",\n \"complementary\",\n \"monochromatic\",\n \"splitComplementary\",\n \"square\",\n \"tetradic\",\n \"triadic\"\n ]\n }\n },\n \"primaryColor\": {\n \"value\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n }\n }\n }\n }\n },\n \"ThemeRecipeOverrides\": {\n \"id\": \"ThemeRecipeOverrides\",\n \"descriptor\": {\n \"kind\": \"object\",\n \"fields\": {\n \"components\": {\n \"value\": {\n \"kind\": \"value-map\",\n \"key\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n },\n \"value\": {\n \"kind\": \"ref\",\n \"packageName\": \"typescript\",\n \"id\": \"Readonly\"\n }\n },\n \"optional\": true\n },\n \"patterns\": {\n \"value\": {\n \"kind\": \"value-map\",\n \"key\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n },\n \"value\": {\n \"kind\": \"ref\",\n \"packageName\": \"typescript\",\n \"id\": \"Readonly\"\n }\n },\n \"optional\": true\n }\n }\n }\n },\n \"ThemeTypographyHeadingOverrides\": {\n \"id\": \"ThemeTypographyHeadingOverrides\",\n \"descriptor\": {\n \"kind\": \"object\",\n \"fields\": {\n \"lineHeight\": {\n \"value\": {\n \"kind\": \"scalar\",\n \"type\": \"number\"\n },\n \"optional\": true\n },\n \"size\": {\n \"value\": {\n \"kind\": \"scalar\",\n \"type\": \"number\"\n },\n \"optional\": true\n },\n \"weight\": {\n \"value\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n },\n \"optional\": true\n }\n }\n }\n },\n \"ThemeTypographyTokenOverrides\": {\n \"id\": \"ThemeTypographyTokenOverrides\",\n \"descriptor\": {\n \"kind\": \"object\",\n \"fields\": {\n \"headings\": {\n \"value\": {\n \"kind\": \"value-map\",\n \"key\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n },\n \"value\": {\n \"kind\": \"ref\",\n \"id\": \"ThemeTypographyHeadingOverrides\"\n }\n },\n \"optional\": true\n },\n \"sizes\": {\n \"value\": {\n \"kind\": \"value-map\",\n \"key\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n },\n \"value\": {\n \"kind\": \"scalar\",\n \"type\": \"number\"\n }\n },\n \"optional\": true\n },\n \"weights\": {\n \"value\": {\n \"kind\": \"value-map\",\n \"key\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n },\n \"value\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n }\n },\n \"optional\": true\n }\n }\n }\n }\n }\n} as const satisfies StructureDescriptorDocument;\n"]}
1	+ {"version":3,"file":"generated.js","sourceRoot":"","sources":["../../src/structure/generated.ts"],"names":[],"mappings":"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","sourcesContent":["/* This file is generated by @ankhorage/devtools. Do not edit manually. */\nimport type { StructureDescriptorDocument } from '@ankhorage/contracts/structure';\n\nexport const STRUCTURE_DESCRIPTOR_COMPILER_VERSION = '6.0.3';\nexport const STRUCTURE_DESCRIPTOR_FINGERPRINT = 'sha256:67f55755ba8bc7a6ba9239317adbad41d62c006976654188a9f817e3c807509a';\n\nexport const STRUCTURE_DESCRIPTOR = {\n \"protocolVersion\": 1,\n \"packageName\": \"@ankhorage/contracts\",\n \"packageVersion\": \"26.7.0\",\n \"roots\": {\n \"auth-flow\": \"AuthFlowConfig\",\n \"auth-profile\": \"AuthProfileSpec\",\n \"auth-sign-in\": \"AuthSignInSpec\",\n \"auth-sign-up\": \"AuthSignUpSpec\",\n \"screen-metadata\": \"ScreenMetadataSpec\",\n \"screen-requirements\": \"ScreenRequirements\",\n \"theme-config\": \"ThemeConfig\"\n },\n \"descriptors\": {\n \"AuthFlowConfig\": {\n \"id\": \"AuthFlowConfig\",\n \"descriptor\": {\n \"kind\": \"object\",\n \"fields\": {\n \"forgotPasswordRoute\": {\n \"value\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n },\n \"optional\": true\n },\n \"otpRoute\": {\n \"value\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n },\n \"optional\": true\n },\n \"postSignInRoute\": {\n \"value\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n }\n },\n \"signInRoute\": {\n \"value\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n }\n },\n \"signOutRoute\": {\n \"value\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n },\n \"optional\": true\n },\n \"signUpRoute\": {\n \"value\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n },\n \"optional\": true\n },\n \"unauthorizedRoute\": {\n \"value\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n },\n \"optional\": true\n }\n }\n }\n },\n \"AuthProfileField\": {\n \"id\": \"AuthProfileField\",\n \"descriptor\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n }\n },\n \"AuthProfileSpec\": {\n \"id\": \"AuthProfileSpec\",\n \"descriptor\": {\n \"kind\": \"object\",\n \"fields\": {\n \"createStrategy\": {\n \"value\": {\n \"kind\": \"enum\",\n \"values\": [\n \"api\",\n \"app\",\n \"trigger\"\n ]\n },\n \"optional\": true\n },\n \"fields\": {\n \"value\": {\n \"kind\": \"ordered-list\",\n \"item\": {\n \"kind\": \"ref\",\n \"id\": \"AuthProfileField\"\n }\n }\n },\n \"primaryKey\": {\n \"value\": {\n \"kind\": \"enum\",\n \"values\": [\n \"authUserId\"\n ]\n },\n \"optional\": true\n },\n \"table\": {\n \"value\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n },\n \"optional\": true\n },\n \"updateStrategy\": {\n \"value\": {\n \"kind\": \"enum\",\n \"values\": [\n \"api\",\n \"app\"\n ]\n },\n \"optional\": true\n }\n }\n }\n },\n \"AuthSignInSpec\": {\n \"id\": \"AuthSignInSpec\",\n \"descriptor\": {\n \"kind\": \"object\",\n \"fields\": {\n \"identifiers\": {\n \"value\": {\n \"kind\": \"ordered-list\",\n \"item\": {\n \"kind\": \"enum\",\n \"values\": [\n \"email\",\n \"phone\",\n \"username\"\n ]\n }\n }\n }\n }\n }\n },\n \"AuthSignUpField\": {\n \"id\": \"AuthSignUpField\",\n \"descriptor\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n }\n },\n \"AuthSignUpSpec\": {\n \"id\": \"AuthSignUpSpec\",\n \"descriptor\": {\n \"kind\": \"object\",\n \"fields\": {\n \"optionalFields\": {\n \"value\": {\n \"kind\": \"ordered-list\",\n \"item\": {\n \"kind\": \"ref\",\n \"id\": \"AuthSignUpField\"\n }\n },\n \"optional\": true\n },\n \"requiredFields\": {\n \"value\": {\n \"kind\": \"ordered-list\",\n \"item\": {\n \"kind\": \"ref\",\n \"id\": \"AuthSignUpField\"\n }\n }\n },\n \"signUpPolicy\": {\n \"value\": {\n \"kind\": \"enum\",\n \"values\": [\n \"autoSignIn\",\n \"requireVerification\"\n ]\n },\n \"optional\": true\n }\n }\n }\n },\n \"ScreenMetadataSpec\": {\n \"id\": \"ScreenMetadataSpec\",\n \"descriptor\": {\n \"kind\": \"object\",\n \"fields\": {\n \"description\": {\n \"value\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n },\n \"optional\": true\n },\n \"id\": {\n \"value\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n }\n },\n \"name\": {\n \"value\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n }\n },\n \"title\": {\n \"value\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n },\n \"optional\": true\n }\n }\n }\n },\n \"ScreenRequirements\": {\n \"id\": \"ScreenRequirements\",\n \"descriptor\": {\n \"kind\": \"object\",\n \"fields\": {\n \"capabilities\": {\n \"value\": {\n \"kind\": \"set\",\n \"member\": {\n \"kind\": \"enum\",\n \"values\": [\n \"barcodeScanner\",\n \"cameraPreview\",\n \"clipboard\",\n \"ebookReader\",\n \"filePicker\",\n \"location\",\n \"mediaPicker\",\n \"notifications\"\n ]\n }\n },\n \"optional\": true\n },\n \"permissions\": {\n \"value\": {\n \"kind\": \"set\",\n \"member\": {\n \"kind\": \"enum\",\n \"values\": [\n \"camera\",\n \"clipboard\",\n \"locationBackground\",\n \"locationForeground\",\n \"mediaLibrary\",\n \"mediaLibraryWrite\",\n \"microphone\",\n \"notifications\"\n ]\n }\n },\n \"optional\": true\n }\n }\n }\n },\n \"ThemeConfig\": {\n \"id\": \"ThemeConfig\",\n \"descriptor\": {\n \"kind\": \"object\",\n \"fields\": {\n \"dark\": {\n \"value\": {\n \"kind\": \"ref\",\n \"id\": \"ThemeModeConfig\"\n }\n },\n \"id\": {\n \"value\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n }\n },\n \"light\": {\n \"value\": {\n \"kind\": \"ref\",\n \"id\": \"ThemeModeConfig\"\n }\n },\n \"name\": {\n \"value\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n }\n },\n \"recipes\": {\n \"value\": {\n \"kind\": \"ref\",\n \"id\": \"ThemeRecipeOverrides\"\n },\n \"optional\": true\n },\n \"tokens\": {\n \"value\": {\n \"kind\": \"ref\",\n \"id\": \"ThemeGlobalTokenOverrides\"\n },\n \"optional\": true\n }\n }\n }\n },\n \"ThemeGlobalTokenOverrides\": {\n \"id\": \"ThemeGlobalTokenOverrides\",\n \"descriptor\": {\n \"kind\": \"object\",\n \"fields\": {\n \"radii\": {\n \"value\": {\n \"kind\": \"value-map\",\n \"key\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n },\n \"value\": {\n \"kind\": \"scalar\",\n \"type\": \"number\"\n }\n },\n \"optional\": true\n },\n \"shadows\": {\n \"value\": {\n \"kind\": \"value-map\",\n \"key\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n },\n \"value\": {\n \"kind\": \"scalar\",\n \"type\": \"number\"\n }\n },\n \"optional\": true\n },\n \"spacing\": {\n \"value\": {\n \"kind\": \"value-map\",\n \"key\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n },\n \"value\": {\n \"kind\": \"scalar\",\n \"type\": \"number\"\n }\n },\n \"optional\": true\n },\n \"typography\": {\n \"value\": {\n \"kind\": \"ref\",\n \"id\": \"ThemeTypographyTokenOverrides\"\n },\n \"optional\": true\n }\n }\n }\n },\n \"ThemeModeConfig\": {\n \"id\": \"ThemeModeConfig\",\n \"descriptor\": {\n \"kind\": \"object\",\n \"fields\": {\n \"harmony\": {\n \"value\": {\n \"kind\": \"enum\",\n \"values\": [\n \"analogous\",\n \"complementary\",\n \"monochromatic\",\n \"splitComplementary\",\n \"square\",\n \"tetradic\",\n \"triadic\"\n ]\n }\n },\n \"primaryColor\": {\n \"value\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n }\n }\n }\n }\n },\n \"ThemeRecipeOverrides\": {\n \"id\": \"ThemeRecipeOverrides\",\n \"descriptor\": {\n \"kind\": \"object\",\n \"fields\": {\n \"components\": {\n \"value\": {\n \"kind\": \"value-map\",\n \"key\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n },\n \"value\": {\n \"kind\": \"ref\",\n \"packageName\": \"typescript\",\n \"id\": \"Readonly\"\n }\n },\n \"optional\": true\n },\n \"patterns\": {\n \"value\": {\n \"kind\": \"value-map\",\n \"key\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n },\n \"value\": {\n \"kind\": \"ref\",\n \"packageName\": \"typescript\",\n \"id\": \"Readonly\"\n }\n },\n \"optional\": true\n }\n }\n }\n },\n \"ThemeTypographyHeadingOverrides\": {\n \"id\": \"ThemeTypographyHeadingOverrides\",\n \"descriptor\": {\n \"kind\": \"object\",\n \"fields\": {\n \"lineHeight\": {\n \"value\": {\n \"kind\": \"scalar\",\n \"type\": \"number\"\n },\n \"optional\": true\n },\n \"size\": {\n \"value\": {\n \"kind\": \"scalar\",\n \"type\": \"number\"\n },\n \"optional\": true\n },\n \"weight\": {\n \"value\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n },\n \"optional\": true\n }\n }\n }\n },\n \"ThemeTypographyTokenOverrides\": {\n \"id\": \"ThemeTypographyTokenOverrides\",\n \"descriptor\": {\n \"kind\": \"object\",\n \"fields\": {\n \"headings\": {\n \"value\": {\n \"kind\": \"value-map\",\n \"key\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n },\n \"value\": {\n \"kind\": \"ref\",\n \"id\": \"ThemeTypographyHeadingOverrides\"\n }\n },\n \"optional\": true\n },\n \"sizes\": {\n \"value\": {\n \"kind\": \"value-map\",\n \"key\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n },\n \"value\": {\n \"kind\": \"scalar\",\n \"type\": \"number\"\n }\n },\n \"optional\": true\n },\n \"weights\": {\n \"value\": {\n \"kind\": \"value-map\",\n \"key\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n },\n \"value\": {\n \"kind\": \"scalar\",\n \"type\": \"string\"\n }\n },\n \"optional\": true\n }\n }\n }\n }\n }\n} as const satisfies StructureDescriptorDocument;\n"]}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@ankhorage/contracts",
-  "version": "26.6.0",
+  "version": "26.7.0",
   "main": "./dist/index.js",
   "ankh": {
     "category": "contracts",
@@ -44,7 +44,7 @@
     "@ankhorage/utility": "^1.10.0"
   },
   "devDependencies": {
-    "@ankhorage/devtools": "^2.4.1",
+    "@ankhorage/devtools": "^2.4.3",
     "@ankhorage/paradox": "^0.3.6",
     "@types/bun": "^1.4.2",
     "@types/node": "^26.6.6",
@@ -142,6 +142,10 @@
     "./capability": {
       "types": "./dist/capability.d.ts",
       "default": "./dist/capability.js"
+    },
+    "./flow": {
+      "types": "./dist/flow.d.ts",
+      "default": "./dist/flow.js"
     }
   },
   "description": "Serializable app, capability, binding, theme, auth, and secret-store contracts for Ankhorage.",

package/src/flow.test.ts ADDED Viewed

@@ -0,0 +1,218 @@
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { describe, expect, it } from 'bun:test';
+import type {
+  FlowApprovalRequest,
+  FlowDefinition,
+  FlowNodeConfig,
+  FlowRunSnapshot,
+  FlowSecretRef,
+} from './flow.js';
+type JsonRecord = Readonly<Record<string, unknown>>;
+const isRecord = (value: unknown): value is JsonRecord =>
+  typeof value === 'object' && value !== null && !Array.isArray(value);
+const isString = (value: unknown): value is string => typeof value === 'string';
+const isFlowFixture = (value: unknown): value is FlowDefinition => {
+  if (
+    !isRecord(value) ||
+    !isString(value.id) ||
+    !Number.isInteger(value.version) ||
+    !isString(value.title)
+  ) {
+    return false;
+  }
+  return (
+    Array.isArray(value.nodes) &&
+    value.nodes.every(
+      (node) =>
+        isRecord(node) &&
+        isString(node.id) &&
+        isRecord(node.capability) &&
+        isString(node.capability.providerId) &&
+        isString(node.capability.capabilityId) &&
+        Array.isArray(node.ports) &&
+        node.ports.every(
+          (port) =>
+            isRecord(port) &&
+            isString(port.id) &&
+            (port.direction === 'input' || port.direction === 'output'),
+        ),
+    ) &&
+    Array.isArray(value.edges) &&
+    value.edges.every(
+      (edge) =>
+        isRecord(edge) &&
+        isString(edge.id) &&
+        isRecord(edge.source) &&
+        isString(edge.source.nodeId) &&
+        isString(edge.source.portId) &&
+        isRecord(edge.target) &&
+        isString(edge.target.nodeId) &&
+        isString(edge.target.portId),
+    ) &&
+    Array.isArray(value.triggers) &&
+    value.triggers.every(
+      (trigger) => isRecord(trigger) && isString(trigger.id) && isString(trigger.kind),
+    )
+  );
+};
+const definition = {
+  id: 'social-publish',
+  version: 3,
+  title: 'Publish approved social media',
+  nodes: [
+    {
+      id: 'compose',
+      capability: { providerId: '@ankhorage/flow/social', capabilityId: 'post.compose' },
+      config: {
+        audience: { kind: 'inline', value: { segment: 'subscribers' } },
+        credential: { kind: 'secret', ref: 'flow/social/publisher' },
+      },
+      ports: [
+        { id: 'draft', direction: 'input', required: true, data: { schema: { type: 'object' } } },
+        { id: 'post', direction: 'output', data: { schema: { type: 'object' } } },
+      ],
+    },
+    {
+      id: 'notify',
+      capability: { providerId: '@ankhorage/flow/social', capabilityId: 'notification.send' },
+      ports: [{ id: 'post', direction: 'input', required: true }],
+    },
+  ],
+  edges: [
+    {
+      id: 'notify-success',
+      source: { nodeId: 'compose', portId: 'post' },
+      target: { nodeId: 'notify', portId: 'post' },
+      condition: { kind: 'outcome', outcome: 'success' },
+    },
+  ],
+  triggers: [{ id: 'manual', kind: 'manual' }],
+} as const satisfies FlowDefinition;
+const run = {
+  id: 'run-42',
+  flow: { id: definition.id, version: definition.version },
+  status: 'waiting_for_approval',
+  trigger: { triggerId: 'manual', kind: 'manual' },
+  createdAt: '2026-11-12T09:00:00.000Z',
+  steps: [
+    {
+      id: 'step-compose',
+      nodeId: 'compose',
+      status: 'succeeded',
+      attempt: 1,
+      output: {
+        post: { kind: 'artifact', artifactId: 'artifact-post', mediaType: 'application/json' },
+      },
+    },
+  ],
+} as const satisfies FlowRunSnapshot;
+const approval = {
+  id: 'approval-7',
+  runId: run.id,
+  step: { id: 'step-compose', nodeId: 'compose', attempt: 1, runId: run.id },
+  status: 'pending',
+  requestedAt: '2026-11-12T09:01:00.000Z',
+  context: { kind: 'artifact', artifactId: 'artifact-post' },
+} as const satisfies FlowApprovalRequest;
+describe('Flow contract serialization', () => {
+  it('round-trips a standalone versioned workflow fixture', () => {
+    const fixturePath = join(process.cwd(), 'test/flow/fixtures/versioned-workflow.json');
+    const fixture = JSON.parse(readFileSync(fixturePath, 'utf8')) as unknown;
+    expect(isFlowFixture(fixture)).toBe(true);
+    expect(JSON.parse(JSON.stringify(fixture))).toEqual(fixture);
+  });
+  it('rejects malformed fixture structure independently of JSON serialization', () => {
+    const malformedFixture = {
+      id: 'missing-port-direction',
+      version: 1,
+      title: 'Malformed fixture',
+      nodes: [
+        {
+          id: 'compose',
+          capability: { providerId: '@ankhorage/flow/social', capabilityId: 'post.compose' },
+          ports: [{ id: 'post', direction: 'sideways' }],
+        },
+      ],
+      edges: [],
+      triggers: [],
+    };
+    expect(isFlowFixture(malformedFixture)).toBe(false);
+    expect(JSON.parse(JSON.stringify(malformedFixture))).toEqual(malformedFixture);
+  });
+  it('round-trips a versioned graph, run snapshot, and approval without runtime values', () => {
+    expect(JSON.parse(JSON.stringify({ definition, run, approval }))).toEqual({
+      definition,
+      run,
+      approval,
+    });
+  });
+});
+describe('Flow contract boundaries', () => {
+  it('accepts secret references but excludes inline secret material from their contract', () => {
+    const secret = {
+      kind: 'secret',
+      ref: 'flow/social/publisher',
+    } as const satisfies FlowSecretRef;
+    expect(JSON.parse(JSON.stringify(secret))).toEqual(secret);
+    // @ts-expect-error Flow secret references must not carry secret material.
+    const inlineSecret: FlowSecretRef = {
+      kind: 'secret',
+      ref: 'flow/social/publisher',
+      value: 'secret',
+    };
+    expect(inlineSecret).toBeDefined();
+    // @ts-expect-error Node configuration requires an explicit data or secret reference.
+    const plaintextCredential: FlowNodeConfig = { credential: 'api-key' };
+    expect(plaintextCredential).toBeDefined();
+  });
+  it('requires a JSON Pointer whenever a condition compares a port value', () => {
+    // @ts-expect-error Value conditions must name an RFC 6901 JSON Pointer, including '' for root.
+    const implicitRootComparison: FlowDefinition = {
+      ...definition,
+      edges: [
+        {
+          id: 'implicit-root',
+          source: { nodeId: 'compose', portId: 'post' },
+          target: { nodeId: 'notify', portId: 'post' },
+          condition: { kind: 'value', equals: 'published' },
+        },
+      ],
+    };
+    expect(implicitRootComparison).toBeDefined();
+  });
+  it('keeps node ports directional and edge endpoints precise', () => {
+    // @ts-expect-error Edges may only originate at a named port.
+    const incompleteEdge: FlowDefinition = {
+      ...definition,
+      edges: [
+        {
+          id: 'missing-port',
+          source: { nodeId: 'compose' },
+          target: { nodeId: 'notify', portId: 'post' },
+        },
+      ],
+    };
+    expect(incompleteEdge).toBeDefined();
+  });
+});

package/src/flow.ts ADDED Viewed

@@ -0,0 +1,254 @@
+import type { DataSchemaSlot } from './data/schemas.js';
+import type { DataContractValue } from './data/values.js';
+import type { SecretRef } from './secrets.js';
+export type FlowId = string;
+export type FlowNodeId = string;
+export type FlowPortId = string;
+export type FlowEdgeId = string;
+export type FlowRunId = string;
+export type FlowStepId = string;
+export type FlowArtifactId = string;
+export type FlowProviderCapabilityId = string;
+/** A serializable reference to a provider-owned flow capability. */
+export interface FlowProviderCapabilityRef {
+  readonly providerId: string;
+  readonly capabilityId: FlowProviderCapabilityId;
+}
+/** A persisted artifact reference for data too large or unsuitable for inline graph data. */
+export interface FlowArtifactRef {
+  readonly kind: 'artifact';
+  readonly artifactId: FlowArtifactId;
+  readonly mediaType?: string;
+  readonly byteLength?: number;
+  readonly checksum?: string;
+}
+/*** A schema-agnostic inline data reference.
+ *
+ * Inline values are ordinary non-secret data. Consumers must reject a value at a credential
+ * configuration position and require a `FlowSecretRef` there; TypeScript cannot prove that
+ * invariant after JSON has crossed a trust boundary.
+ */
+export interface FlowInlineDataRef {
+  readonly kind: 'inline';
+  readonly value: DataContractValue;
+}
+/** A schema-agnostic data reference exchanged by node ports, runs, and traces. */
+export type FlowDataRef = FlowArtifactRef | FlowInlineDataRef;
+/*** A secret-store reference that deliberately excludes secret material.
+ *
+ * @security flow.test.ts#accepts secret references but excludes inline secret material from their contract
+ *
+ * Credential configuration must use this reference. Flow consumers must validate provider
+ * configuration at their boundary, reject inline credentials, and redact secrets from errors and
+ * traces. This portable DTO cannot determine which arbitrary provider fields are credentials, so
+ * it provides no runtime validation and makes no static guarantee for untyped JSON.
+ */
+export interface FlowSecretRef {
+  readonly kind: 'secret';
+  readonly ref: SecretRef;
+}
+/*** JSON-safe node configuration references.
+ *
+ * A configuration value is always explicitly either non-secret data or a secret-store reference;
+ * raw JSON values are intentionally not accepted. Provider consumers own validation of the
+ * declared configuration shape and credential positions before execution.
+ */
+export type FlowNodeConfigValue = FlowDataRef | FlowSecretRef;
+export type FlowNodeConfig = Readonly<Record<string, FlowNodeConfigValue>>;
+/** A typed node port. Direction determines whether a node consumes or produces the port value. */
+export interface FlowPortDescriptor {
+  readonly id: FlowPortId;
+  readonly direction: 'input' | 'output';
+  readonly label?: string;
+  readonly description?: string;
+  readonly required?: boolean;
+  readonly data?: DataSchemaSlot;
+}
+/** One provider-backed executable step within a portable flow graph. */
+export interface FlowNode {
+  readonly id: FlowNodeId;
+  readonly capability: FlowProviderCapabilityRef;
+  readonly label?: string;
+  readonly config?: FlowNodeConfig;
+  readonly ports: readonly FlowPortDescriptor[];
+}
+/*** A condition declared on an edge without embedding executable expressions.
+ *
+ * A `value` condition evaluates `path` as an RFC 6901 JSON Pointer against the source port's
+ * JSON value; the empty string denotes the complete value. Missing-pointer evaluation does not
+ * match. `equals` uses JSON structural equality: values have the same type and recursive array
+ * order and object member/value pairs, independent of object member order. Engines must not use
+ * coercion, locale comparison, or executable expressions.
+ */
+export type FlowEdgeCondition =
+  | { readonly kind: 'always' }
+  | { readonly kind: 'outcome'; readonly outcome: 'failure' | 'success' }
+  | { readonly kind: 'value'; readonly path: string; readonly equals: DataContractValue };
+/** A directed connection from one output port to one input port. */
+export interface FlowEdge {
+  readonly id: FlowEdgeId;
+  readonly source: { readonly nodeId: FlowNodeId; readonly portId: FlowPortId };
+  readonly target: { readonly nodeId: FlowNodeId; readonly portId: FlowPortId };
+  readonly condition?: FlowEdgeCondition;
+}
+/*** A portable trigger declaration; runtime scheduling and delivery remain provider-owned.
+ *
+ * A schedule uses a five-field POSIX cron expression: minute, hour, day of month, month, and day
+ * of week. Seconds, years, macros, and implementation-specific extensions are invalid. `timezone`
+ * is an IANA time-zone name and defaults to `Etc/UTC`. Match it against local wall-clock time; a
+ * spring-forward nonexistent local time is skipped and each occurrence of a repeated local time
+ * during a fall-back transition fires separately. When both day-of-month and day-of-week are
+ * restricted, either match is sufficient, following POSIX cron semantics.
+ */
+export type FlowTrigger =
+  | { readonly id: string; readonly kind: 'manual' }
+  | {
+      readonly id: string;
+      readonly kind: 'schedule';
+      readonly cron: string;
+      readonly timezone?: string;
+    }
+  | {
+      readonly id: string;
+      readonly kind: 'event';
+      readonly capability: FlowProviderCapabilityRef;
+      readonly event: string;
+    }
+  | { readonly id: string; readonly kind: 'webhook'; readonly path: string };
+/** An immutable revision of a portable workflow graph. */
+export interface FlowDefinition {
+  readonly id: FlowId;
+  readonly version: number;
+  readonly title: string;
+  readonly description?: string;
+  readonly nodes: readonly FlowNode[];
+  readonly edges: readonly FlowEdge[];
+  readonly triggers: readonly FlowTrigger[];
+}
+/** An immutable workflow revision reference. */
+export interface FlowDefinitionRef {
+  readonly id: FlowId;
+  readonly version: number;
+}
+export type FlowExecutionStatus =
+  | 'cancelled'
+  | 'failed'
+  | 'pending'
+  | 'running'
+  | 'succeeded'
+  | 'timed_out'
+  | 'waiting_for_approval';
+/** A portable error observation that never carries a host Error object. */
+export interface FlowError {
+  readonly code: string;
+  readonly message: string;
+  readonly retryable: boolean;
+  readonly details?: FlowDataRef;
+}
+/** A redaction-safe trace observation emitted by a run or step. */
+export interface FlowTraceEvent {
+  readonly timestamp: string;
+  readonly level: 'debug' | 'error' | 'info' | 'warn';
+  readonly message: string;
+  readonly attributes?: Readonly<Record<string, DataContractValue>>;
+}
+/*** A durable snapshot of one execution attempt for a graph node.
+ *
+ * `attempt` is a one-based, monotonically increasing number for this run and node. A retry has a
+ * new step snapshot and attempt number; consumers must not overwrite a completed attempt.
+ */
+export interface FlowStepSnapshot {
+  readonly id: FlowStepId;
+  readonly nodeId: FlowNodeId;
+  readonly status: FlowExecutionStatus;
+  readonly attempt: number;
+  readonly startedAt?: string;
+  readonly completedAt?: string;
+  readonly input?: Readonly<Record<FlowPortId, FlowDataRef>>;
+  readonly output?: Readonly<Record<FlowPortId, FlowDataRef>>;
+  readonly error?: FlowError;
+  readonly trace?: readonly FlowTraceEvent[];
+}
+/** A stable reference to one immutable step attempt in a run. */
+export interface FlowStepRef {
+  readonly runId: FlowRunId;
+  readonly id: FlowStepId;
+  readonly nodeId: FlowNodeId;
+  readonly attempt: number;
+}
+/** A reference to the triggering event or request that started a run. */
+export interface FlowRunTrigger {
+  readonly triggerId: string;
+  readonly kind: FlowTrigger['kind'];
+  readonly data?: FlowDataRef;
+}
+/*** A durable snapshot of an execution against one immutable flow revision.
+ *
+ * A run begins `pending`, may move to `running` or `cancelled`, and is terminal once
+ * `cancelled`, `failed`, `succeeded`, or `timed_out`. `waiting_for_approval` pauses an otherwise
+ * running run; resolving its pending approval resumes it or ends it as cancelled or failed.
+ * Consumers must validate these transitions and must retain the referenced definition revision.
+ */
+export interface FlowRunSnapshot {
+  readonly id: FlowRunId;
+  readonly flow: FlowDefinitionRef;
+  readonly status: FlowExecutionStatus;
+  readonly trigger: FlowRunTrigger;
+  readonly createdAt: string;
+  readonly startedAt?: string;
+  readonly completedAt?: string;
+  readonly input?: Readonly<Record<FlowPortId, FlowDataRef>>;
+  readonly output?: Readonly<Record<FlowPortId, FlowDataRef>>;
+  readonly steps: readonly FlowStepSnapshot[];
+  readonly error?: FlowError;
+  readonly trace?: readonly FlowTraceEvent[];
+}
+/** A stable reference to a run against one immutable workflow revision. */
+export interface FlowRunRef {
+  readonly id: FlowRunId;
+  readonly flow: FlowDefinitionRef;
+}
+export type FlowApprovalStatus = 'approved' | 'cancelled' | 'expired' | 'pending' | 'rejected';
+/*** A serializable human-approval request associated with one durable run.
+ *
+ * An approval starts `pending` and transitions exactly once to `approved`, `rejected`, `expired`,
+ * or `cancelled`; those states are terminal. A step approval identifies its exact attempt so a
+ * later retry cannot resolve an earlier request. Consumers validate timestamps and transitions.
+ */
+export interface FlowApprovalRequest {
+  readonly id: string;
+  readonly runId: FlowRunId;
+  readonly step?: FlowStepRef;
+  readonly status: FlowApprovalStatus;
+  readonly requestedAt: string;
+  readonly expiresAt?: string;
+  readonly resolvedAt?: string;
+  readonly requestedBy?: string;
+  readonly resolvedBy?: string;
+  readonly message?: string;
+  readonly context?: FlowDataRef;
+}

package/src/flowPackedConsumer.test.ts ADDED Viewed

@@ -0,0 +1,98 @@
+import { mkdirSync, mkdtempSync, readdirSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { describe, expect, it } from 'bun:test';
+const packageRoot = process.cwd();
+const temporaryCacheDirectory = join(tmpdir(), 'contracts-flow-consumer-cache');
+const runCommand = (command: string[], cwd: string): string => {
+  const result = Bun.spawnSync(command, {
+    cwd,
+    env: {
+      ...process.env,
+      BUN_INSTALL_CACHE_DIR: temporaryCacheDirectory,
+      npm_config_cache: temporaryCacheDirectory,
+    },
+  });
+  const output = `${result.stdout.toString()}${result.stderr.toString()}`;
+  expect(result.exitCode, output).toBe(0);
+  return output;
+};
+const writeConsumerFiles = (consumerDirectory: string): void => {
+  writeFileSync(
+    join(consumerDirectory, 'consumer.mjs'),
+    [
+      "import {} from '@ankhorage/contracts/flow';",
+      "console.log('published flow contract is available');",
+    ].join('\n'),
+  );
+  writeFileSync(
+    join(consumerDirectory, 'consumer.ts'),
+    [
+      "import type { FlowDefinition } from '@ankhorage/contracts/flow';",
+      "const flow: FlowDefinition = { id: 'consumer-flow', version: 1, title: 'Consumer flow', nodes: [], edges: [], triggers: [{ id: 'manual', kind: 'manual' }] };",
+      'void flow;',
+    ].join('\n'),
+  );
+};
+const packAndInstall = (consumerDirectory: string, packedDirectory: string): void => {
+  runCommand(['bun', 'run', 'build'], packageRoot);
+  runCommand(
+    ['npm', 'pack', '--ignore-scripts', '--pack-destination', packedDirectory],
+    packageRoot,
+  );
+  const archiveName = readdirSync(packedDirectory).find((entry) => entry.endsWith('.tgz'));
+  expect(archiveName).toBeDefined();
+  runCommand(
+    ['bun', 'add', '--ignore-scripts', join(packedDirectory, archiveName ?? 'missing.tgz')],
+    consumerDirectory,
+  );
+};
+const verifyConsumer = (consumerDirectory: string): void => {
+  runCommand(['node', 'consumer.mjs'], consumerDirectory);
+  runCommand(['bun', 'consumer.mjs'], consumerDirectory);
+  runCommand(
+    [
+      join(packageRoot, 'node_modules/.bin/tsc'),
+      '--noEmit',
+      '--module',
+      'NodeNext',
+      '--moduleResolution',
+      'NodeNext',
+      '--target',
+      'ES2022',
+      '--skipLibCheck',
+      'consumer.ts',
+    ],
+    consumerDirectory,
+  );
+};
+describe('packed Flow consumer', () => {
+  it('supports native Node ESM, Bun, and public declarations', () => {
+    const temporaryDirectory = mkdtempSync(join(tmpdir(), 'contracts-flow-consumer-'));
+    const consumerDirectory = join(temporaryDirectory, 'package');
+    const packedDirectory = join(temporaryDirectory, 'packed');
+    try {
+      mkdirSync(consumerDirectory);
+      mkdirSync(packedDirectory);
+      writeFileSync(
+        join(consumerDirectory, 'package.json'),
+        JSON.stringify({ name: 'contracts-flow-consumer', private: true, type: 'module' }),
+      );
+      writeConsumerFiles(consumerDirectory);
+      packAndInstall(consumerDirectory, packedDirectory);
+      verifyConsumer(consumerDirectory);
+    } finally {
+      rmSync(temporaryDirectory, { force: true, recursive: true });
+    }
+  });
+});

package/src/index.ts CHANGED Viewed

@@ -9,6 +9,7 @@ export * from './db.js';
 export * from './deploy.js';
 export * from './deployProvider.js';
 export * from './environments.js';
+export * from './flow.js';
 export * from './infra.js';
 export * from './media.js';
 export * from './navigator.js';

package/src/structure/generated.ts CHANGED Viewed

@@ -2,12 +2,12 @@
 import type { StructureDescriptorDocument } from '@ankhorage/contracts/structure';
 export const STRUCTURE_DESCRIPTOR_COMPILER_VERSION = '6.0.3';
-export const STRUCTURE_DESCRIPTOR_FINGERPRINT = 'sha256:dd8057c752c877b62bdc5c8db41135bd76c55dedf9bf4e1a13d7bf977f9cca56';
+export const STRUCTURE_DESCRIPTOR_FINGERPRINT = 'sha256:67f55755ba8bc7a6ba9239317adbad41d62c006976654188a9f817e3c807509a';
 export const STRUCTURE_DESCRIPTOR = {
   "protocolVersion": 1,
   "packageName": "@ankhorage/contracts",
-  "packageVersion": "26.6.0",
+  "packageVersion": "26.7.0",
   "roots": {
     "auth-flow": "AuthFlowConfig",
     "auth-profile": "AuthProfileSpec",