@intentic/graph 1.18.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Artur Kurowski
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,29 @@
+# @intentic/graph
+
+The product-agnostic **desired-state IR** and its compiler — the data structure every other package is built around. A node's `type` is an opaque string here; the closed vocabulary lives in [`@intentic/resources`](../resources). This is the base of the dependency graph (depended on by every other package, depends on nothing internal).
+
+## Responsibilities
+
+- Define the serializable graph types: `DesiredStateGraph`, `RawNode`/`ResourceNode`, `Ref`, `SecretRef`, `Readiness`.
+- Compile a map of `RawNode`s into a validated, dependency-ordered `DesiredStateGraph` (`compile`).
+- Provide the primitives others compose with: typed refs between nodes, env-sourced secrets, HTTP readiness gates, and ownership stamps.
+- It does **not** know which resource kinds exist, how to reconcile them, or how to talk to infra — those belong to `resources`/`engine`/`providers`.
+
+## Key files
+
+- [src/types.ts](src/types.ts) — the IR types (`DesiredStateGraph`, `RawNode`, `Ref`, `SecretRef`, `Readiness`).
+- [src/compile.ts](src/compile.ts) — `compile`: RawNode map → graph (validates refs, fills order).
+- [src/topo.ts](src/topo.ts) — `toNodeMap`, `linearize` (topological dependency order).
+- [src/ref.ts](src/ref.ts) — `makeRef`/`refKey`/`isRef`, `env` (env-sourced secret), `httpOk` (readiness gate).
+- [src/stamp.ts](src/stamp.ts) — `formatStamp`/`parseStamp` (resource ownership stamps).
+- [src/serialize.ts](src/serialize.ts) — stable serialization of the graph.
+
+## How it fits
+
+Foundational layer. `resources` constrains node `type`s on top of it; `need-resolver`, `state-resolver`, `engine`, and `sdk` all consume its types; authors import `env` from here (its true source) when writing a `deploy.config.ts`.
+
+## Conventions & gotchas
+
+- Refs are typed pointers to another node's outputs — never inline a downstream value; emit a `Ref` so ordering and resolution stay correct.
+- Secrets are `SecretRef`s with a `source` (`env` or `generated`); keep them as refs, never bake plaintext into a node.
+- Co-located tests in [src/index.test.ts](src/index.test.ts). See [ARCHITECTURE.md](../../ARCHITECTURE.md) for the full pipeline.

package/dist/compile.d.ts

@@ -0,0 +1,3 @@
+import type { DesiredStateGraph, RawNode } from "./types.js";
+export declare const compile: (nodes: ReadonlyMap<string, RawNode>) => DesiredStateGraph;
+//# sourceMappingURL=compile.d.ts.map

package/dist/compile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../src/compile.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAiE,MAAM,YAAY,CAAC;AAY5H,eAAO,MAAM,OAAO,GAAI,OAAO,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,iBA6C7D,CAAC"}

package/dist/compile.js

@@ -0,0 +1,54 @@
+import { refKey } from "./ref.js";
+import { collectRefs, serializeValue } from "./serialize.js";
+import { topoSort } from "./topo.js";
+const serializeReadiness = (readiness) => {
+    const url = typeof readiness.url === "string" ? readiness.url : { $ref: refKey(readiness.url.resourceId, readiness.url.output) };
+    return {
+        check: readiness.check,
+        url,
+        ...(readiness.timeout !== undefined ? { timeout: readiness.timeout } : {}),
+        ...(readiness.status !== undefined ? { status: readiness.status } : {}),
+    };
+};
+export const compile = (nodes) => {
+    const ids = [...nodes.keys()];
+    const known = new Set(ids);
+    const resources = {};
+    const dependsOnMap = new Map();
+    for (const node of nodes.values()) {
+        const inputs = {};
+        for (const [key, value] of Object.entries(node.inputs)) {
+            inputs[key] = serializeValue(value);
+        }
+        const referenced = [
+            ...node.explicitDependsOn,
+            ...Object.values(node.inputs).flatMap(collectRefs),
+            ...(node.readyWhen !== undefined ? collectRefs(node.readyWhen.url) : []),
+        ];
+        const dependsOn = [];
+        for (const dep of referenced) {
+            if (dep === node.id) {
+                continue;
+            }
+            if (!known.has(dep)) {
+                throw new Error(`resource "${node.id}" references unknown resource "${dep}"`);
+            }
+            if (!dependsOn.includes(dep)) {
+                dependsOn.push(dep);
+            }
+        }
+        const resourceNode = {
+            id: node.id,
+            type: node.type,
+            inputs,
+            dependsOn,
+            ...(node.readyWhen !== undefined ? { readyWhen: serializeReadiness(node.readyWhen) } : {}),
+        };
+        resources[node.id] = Object.freeze(resourceNode);
+        dependsOnMap.set(node.id, dependsOn);
+    }
+    topoSort(ids, dependsOnMap);
+    const graph = { version: 1, resources };
+    return Object.freeze(graph);
+};
+//# sourceMappingURL=compile.js.map

package/dist/compile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.js","sourceRoot":"","sources":["../src/compile.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+import type { DesiredStateGraph, RawNode, Readiness, Ref, SecretRef } from "./types.js";
+export declare const env: (key: string) => SecretRef;
+export declare const generated: (key: string) => SecretRef;
+export declare const httpOk: (url: string | Ref<string>, options?: {
+    timeout?: string;
+    status?: number;
+}) => Readiness;
+export declare const linearize: (graph: DesiredStateGraph) => string[];
+export declare const toNodeMap: (nodes: readonly RawNode[]) => Map<string, RawNode>;
+export { compile } from "./compile.js";
+export { isRef, makeRef, refKey } from "./ref.js";
+export { formatStamp, parseStamp, STAMP_KEY } from "./stamp.js";
+export type { DesiredStateGraph, Input, RawNode, Readiness, Ref, ResourceNode, SecretRef, SecretSource, SerializedReadiness, SerializedValue, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAExF,eAAO,MAAM,GAAG,GAAI,KAAK,MAAM,KAAG,SAAkE,CAAC;AAIrG,eAAO,MAAM,SAAS,GAAI,KAAK,MAAM,KAAG,SAAwE,CAAC;AAEjH,eAAO,MAAM,MAAM,GAAI,KAAK,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,UAAU;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,KAAG,SAO9F,CAAC;AAEP,eAAO,MAAM,SAAS,GAAI,OAAO,iBAAiB,KAAG,MAAM,EAO1D,CAAC;AAGF,eAAO,MAAM,SAAS,GAAI,OAAO,SAAS,OAAO,EAAE,KAAG,GAAG,CAAC,MAAM,EAAE,OAAO,CASxE,CAAC;AAEF,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEhE,YAAY,EACR,iBAAiB,EACjB,KAAK,EACL,OAAO,EACP,SAAS,EACT,GAAG,EACH,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,mBAAmB,EACnB,eAAe,GAClB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,32 @@
+import { topoSort } from "./topo.js";
+export const env = (key) => Object.freeze({ kind: "secret", source: "env", key });
+export const generated = (key) => Object.freeze({ kind: "secret", source: "generated", key });
+export const httpOk = (url, options) => Object.freeze({
+    kind: "readiness",
+    check: "httpOk",
+    url,
+    ...(options?.timeout !== undefined ? { timeout: options.timeout } : {}),
+    ...(options?.status !== undefined ? { status: options.status } : {}),
+});
+export const linearize = (graph) => {
+    const ids = Object.keys(graph.resources);
+    const dependsOn = new Map();
+    for (const id of ids) {
+        dependsOn.set(id, graph.resources[id]?.dependsOn ?? []);
+    }
+    return topoSort(ids, dependsOn);
+};
+export const toNodeMap = (nodes) => {
+    const map = new Map();
+    for (const node of nodes) {
+        if (map.has(node.id)) {
+            throw new Error(`duplicate resource id: "${node.id}"`);
+        }
+        map.set(node.id, node);
+    }
+    return map;
+};
+export { compile } from "./compile.js";
+export { isRef, makeRef, refKey } from "./ref.js";
+export { formatStamp, parseStamp, STAMP_KEY } from "./stamp.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAGrC,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,GAAW,EAAa,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;AAIrG,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,GAAW,EAAa,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;AAEjH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,GAAyB,EAAE,OAA+C,EAAa,EAAE,CAC5G,MAAM,CAAC,MAAM,CAAC;IACV,IAAI,EAAE,WAAW;IACjB,KAAK,EAAE,QAAQ;IACf,GAAG;IACH,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACvE,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;CACvE,CAAC,CAAC;AAEP,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAwB,EAAY,EAAE;IAC5D,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACzC,MAAM,SAAS,GAAG,IAAI,GAAG,EAA6B,CAAC;IACvD,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACnB,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;AACpC,CAAC,CAAC;AAGF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAyB,EAAwB,EAAE;IACzE,MAAM,GAAG,GAAG,IAAI,GAAG,EAAmB,CAAC;IACvC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,2BAA2B,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;QAC3D,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC,CAAC;AAEF,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}

package/dist/ref.d.ts

@@ -0,0 +1,6 @@
+import type { Ref, SecretRef } from "./types.js";
+export declare const makeRef: <T = unknown>(resourceId: string, output?: string) => Ref<T>;
+export declare const refKey: (resourceId: string, output?: string) => string;
+export declare const isRef: (value: unknown) => value is Ref<unknown>;
+export declare const isSecret: (value: unknown) => value is SecretRef;
+//# sourceMappingURL=ref.d.ts.map

package/dist/ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref.d.ts","sourceRoot":"","sources":["../src/ref.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEjD,eAAO,MAAM,OAAO,GAAI,CAAC,GAAG,OAAO,EAAE,YAAY,MAAM,EAAE,SAAS,MAAM,KAAG,GAAG,CAAC,CAAC,CACqC,CAAC;AAItH,eAAO,MAAM,MAAM,GAAI,YAAY,MAAM,EAAE,SAAS,MAAM,KAAG,MAAyE,CAAC;AAEvI,eAAO,MAAM,KAAK,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,GAAG,CAAC,OAAO,CACoC,CAAC;AAEhG,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,SAC+C,CAAC"}

package/dist/ref.js

@@ -0,0 +1,5 @@
+export const makeRef = (resourceId, output) => Object.freeze(output === undefined ? { kind: "ref", resourceId } : { kind: "ref", resourceId, output });
+export const refKey = (resourceId, output) => (output === undefined ? resourceId : `${resourceId}.${output}`);
+export const isRef = (value) => typeof value === "object" && value !== null && value.kind === "ref";
+export const isSecret = (value) => typeof value === "object" && value !== null && value.kind === "secret";
+//# sourceMappingURL=ref.js.map

package/dist/ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref.js","sourceRoot":"","sources":["../src/ref.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,OAAO,GAAG,CAAc,UAAkB,EAAE,MAAe,EAAU,EAAE,CAChF,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,CAAW,CAAC;AAItH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,UAAkB,EAAE,MAAe,EAAU,EAAE,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,IAAI,MAAM,EAAE,CAAC,CAAC;AAEvI,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,KAAc,EAAyB,EAAE,CAC3D,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAK,KAA4B,CAAC,IAAI,KAAK,KAAK,CAAC;AAEhG,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAsB,EAAE,CAC3D,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAK,KAA4B,CAAC,IAAI,KAAK,QAAQ,CAAC"}

package/dist/serialize.d.ts

@@ -0,0 +1,4 @@
+import type { SerializedValue } from "./types.js";
+export declare const serializeValue: (value: unknown) => SerializedValue;
+export declare const collectRefs: (value: unknown) => string[];
+//# sourceMappingURL=serialize.d.ts.map

package/dist/serialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../src/serialize.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,eAAO,MAAM,cAAc,GAAI,OAAO,OAAO,KAAG,eAqB/C,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,KAAG,MAAM,EAclD,CAAC"}

package/dist/serialize.js

@@ -0,0 +1,39 @@
+import { isRef, isSecret, refKey } from "./ref.js";
+export const serializeValue = (value) => {
+    if (isRef(value)) {
+        return { $ref: refKey(value.resourceId, value.output) };
+    }
+    if (isSecret(value)) {
+        return { $secret: { source: value.source, key: value.key } };
+    }
+    if (Array.isArray(value)) {
+        return value.map(serializeValue);
+    }
+    if (typeof value === "object" && value !== null) {
+        const result = {};
+        for (const [key, entry] of Object.entries(value)) {
+            result[key] = serializeValue(entry);
+        }
+        return result;
+    }
+    if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+        return value;
+    }
+    throw new Error(`cannot serialize value of type ${typeof value}`);
+};
+export const collectRefs = (value) => {
+    if (isRef(value)) {
+        return [value.resourceId];
+    }
+    if (isSecret(value)) {
+        return [];
+    }
+    if (Array.isArray(value)) {
+        return value.flatMap(collectRefs);
+    }
+    if (typeof value === "object" && value !== null) {
+        return Object.values(value).flatMap(collectRefs);
+    }
+    return [];
+};
+//# sourceMappingURL=serialize.js.map

package/dist/serialize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.js","sourceRoot":"","sources":["../src/serialize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGnD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAc,EAAmB,EAAE;IAC9D,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QACf,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;IAC5D,CAAC;IACD,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAClB,OAAO,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC;IACjE,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IACrC,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAC9C,MAAM,MAAM,GAAoC,EAAE,CAAC;QACnD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/C,MAAM,CAAC,GAAG,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,MAAM,CAAC;IAClB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QACvF,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,kCAAkC,OAAO,KAAK,EAAE,CAAC,CAAC;AACtE,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAc,EAAY,EAAE;IACpD,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC9B,CAAC;IACD,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAClB,OAAO,EAAE,CAAC;IACd,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACtC,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAC9C,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,EAAE,CAAC;AACd,CAAC,CAAC"}

package/dist/stamp.d.ts

@@ -0,0 +1,4 @@
+export declare const STAMP_KEY = "intentic.id";
+export declare const formatStamp: (id: string) => string;
+export declare const parseStamp: (encoded: string) => string | undefined;
+//# sourceMappingURL=stamp.d.ts.map

package/dist/stamp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stamp.d.ts","sourceRoot":"","sources":["../src/stamp.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,SAAS,gBAAgB,CAAC;AAEvC,eAAO,MAAM,WAAW,GAAI,IAAI,MAAM,KAAG,MAA8B,CAAC;AAExE,eAAO,MAAM,UAAU,GAAI,SAAS,MAAM,KAAG,MAAM,GAAG,SAGrD,CAAC"}

package/dist/stamp.js

@@ -0,0 +1,7 @@
+export const STAMP_KEY = "intentic.id";
+export const formatStamp = (id) => `${STAMP_KEY}=${id}`;
+export const parseStamp = (encoded) => {
+    const prefix = `${STAMP_KEY}=`;
+    return encoded.startsWith(prefix) ? encoded.slice(prefix.length) : undefined;
+};
+//# sourceMappingURL=stamp.js.map

package/dist/stamp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stamp.js","sourceRoot":"","sources":["../src/stamp.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,SAAS,GAAG,aAAa,CAAC;AAEvC,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,EAAU,EAAU,EAAE,CAAC,GAAG,SAAS,IAAI,EAAE,EAAE,CAAC;AAExE,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,OAAe,EAAsB,EAAE;IAC9D,MAAM,MAAM,GAAG,GAAG,SAAS,GAAG,CAAC;IAC/B,OAAO,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACjF,CAAC,CAAC"}

package/dist/topo.d.ts

@@ -0,0 +1,2 @@
+export declare const topoSort: (ids: readonly string[], dependsOn: ReadonlyMap<string, readonly string[]>) => string[];
+//# sourceMappingURL=topo.d.ts.map

package/dist/topo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topo.d.ts","sourceRoot":"","sources":["../src/topo.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,QAAQ,GAAI,KAAK,SAAS,MAAM,EAAE,EAAE,WAAW,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,KAAG,MAAM,EAoC1G,CAAC"}

package/dist/topo.js

@@ -0,0 +1,36 @@
+export const topoSort = (ids, dependsOn) => {
+    const inDegree = new Map();
+    const dependents = new Map();
+    for (const id of ids) {
+        inDegree.set(id, 0);
+        dependents.set(id, []);
+    }
+    for (const id of ids) {
+        for (const dep of dependsOn.get(id) ?? []) {
+            inDegree.set(id, (inDegree.get(id) ?? 0) + 1);
+            dependents.get(dep)?.push(id);
+        }
+    }
+    const queue = ids.filter((id) => (inDegree.get(id) ?? 0) === 0);
+    const order = [];
+    while (queue.length > 0) {
+        const id = queue.shift();
+        if (id === undefined) {
+            break;
+        }
+        order.push(id);
+        for (const dependent of dependents.get(id) ?? []) {
+            const remaining = (inDegree.get(dependent) ?? 0) - 1;
+            inDegree.set(dependent, remaining);
+            if (remaining === 0) {
+                queue.push(dependent);
+            }
+        }
+    }
+    if (order.length !== ids.length) {
+        const cycle = ids.filter((id) => !order.includes(id));
+        throw new Error(`dependency cycle: ${cycle.join(" -> ")}`);
+    }
+    return order;
+};
+//# sourceMappingURL=topo.js.map

package/dist/topo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"topo.js","sourceRoot":"","sources":["../src/topo.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,GAAsB,EAAE,SAAiD,EAAY,EAAE;IAC5G,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC3C,MAAM,UAAU,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC/C,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACnB,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QACpB,UAAU,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAC3B,CAAC;IACD,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACnB,KAAK,MAAM,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC;YACxC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC9C,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;QAClC,CAAC;IACL,CAAC;IAED,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IAChE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,EAAE,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;QACzB,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;YACnB,MAAM;QACV,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC;YAC/C,MAAM,SAAS,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YACrD,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YACnC,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;gBAClB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC1B,CAAC;QACL,CAAC;IACL,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,qBAAqB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,57 @@
+export interface Ref<T> {
+    readonly kind: "ref";
+    readonly resourceId: string;
+    readonly output?: string;
+    readonly __type?: T;
+}
+export type SecretSource = "env" | "generated";
+export interface SecretRef {
+    readonly kind: "secret";
+    readonly source: SecretSource;
+    readonly key: string;
+}
+export interface Readiness {
+    readonly kind: "readiness";
+    readonly check: "httpOk";
+    readonly url: string | Ref<string>;
+    readonly timeout?: string;
+    readonly status?: number;
+}
+export type Input<T> = T | Ref<T> | (T extends string ? SecretRef : never);
+export interface RawNode {
+    readonly id: string;
+    readonly type: string;
+    readonly inputs: Readonly<Record<string, unknown>>;
+    readonly explicitDependsOn: readonly string[];
+    readonly readyWhen?: Readiness;
+}
+export type SerializedValue = string | number | boolean | {
+    readonly $ref: string;
+} | {
+    readonly $secret: {
+        readonly source: SecretSource;
+        readonly key: string;
+    };
+} | readonly SerializedValue[] | {
+    readonly [key: string]: SerializedValue;
+};
+export interface SerializedReadiness {
+    readonly check: "httpOk";
+    readonly url: string | {
+        readonly $ref: string;
+    };
+    readonly timeout?: string;
+    readonly status?: number;
+}
+export interface ResourceNode {
+    readonly id: string;
+    readonly type: string;
+    readonly inputs: Readonly<Record<string, SerializedValue>>;
+    readonly dependsOn: readonly string[];
+    readonly readyWhen?: SerializedReadiness;
+}
+export interface DesiredStateGraph {
+    readonly version: 1;
+    readonly resources: Readonly<Record<string, ResourceNode>>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,GAAG,CAAC,CAAC;IAClB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;CACvB;AAID,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,WAAW,CAAC;AAE/C,MAAM,WAAW,SAAS;IACtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,SAAS;IACtB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,MAAM,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,MAAM,GAAG,SAAS,GAAG,KAAK,CAAC,CAAC;AAI3E,MAAM,WAAW,OAAO;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9C,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;CAClC;AAID,MAAM,MAAM,eAAe,GACrB,MAAM,GACN,MAAM,GACN,OAAO,GACP;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzB;IAAE,QAAQ,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC7E,SAAS,eAAe,EAAE,GAC1B;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,eAAe,CAAA;CAAE,CAAC;AAElD,MAAM,WAAW,mBAAmB;IAChC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC;IAC3D,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,SAAS,CAAC,EAAE,mBAAmB,CAAC;CAC5C;AAED,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;CAC9D"}

package/dist/types.js

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

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@intentic/graph",
+  "version": "1.18.0",
+  "description": "",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/radarsu/intentic.git",
+    "directory": "_libs/graph"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": {
+        "@intentic/src": "./src/index.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "@intentic/src": "./src/index.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "dependencies": {
+    "tslib": "2.8.1"
+  },
+  "devDependencies": {
+    "typescript": "5.9.3",
+    "vitest": "4.1.9",
+    "@intentic/tsconfig": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --build --watch",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}