@toolproof-npm/shared 0.1.50 → 0.1.52

package/dist/utils.d.ts

@@ -1,4 +1,24 @@
-import type { ResourceIdJson, ResourceTypeIdJson, ResourceJson, JobJson } from '@toolproof-npm/schema';
+import type { ResourceIdJson, ResourceTypeIdJson, ResourceJson, ResourceMissingJson, JobJson, ResourcePotentialOutputJson, StrategyStateValueJson, CreationContextValueJson } from '@toolproof-npm/schema';
 import type { ResourceMap } from './types.js';
 export declare function extractResourcesByType(resourceMap: ResourceMap, resourceTypeId: ResourceTypeIdJson): Record<ResourceIdJson, ResourceJson>;
 export declare function extractJobMap(resourceMap: ResourceMap): Map<string, JobJson>;
+export type ResolveResult = {
+    status: 'materialized';
+    entry: ResourceJson;
+    path: CreationContextValueJson[];
+} | {
+    status: 'missing';
+    entry: ResourceMissingJson;
+    path: CreationContextValueJson[];
+} | {
+    status: 'blocked-output';
+    entry: ResourcePotentialOutputJson;
+    path: CreationContextValueJson[];
+} | {
+    status: 'unresolved';
+    reason: 'missing-entry' | 'cycle' | 'depth-exceeded';
+    path: CreationContextValueJson[];
+};
+export declare function resolveResourceChain(strategyState: StrategyStateValueJson, start: CreationContextValueJson, opts?: {
+    maxDepth?: number;
+}): ResolveResult;

package/dist/utils.js

@@ -16,3 +16,43 @@ export function extractJobMap(resourceMap) {
     });
     return jobMap;
 }
+export function resolveResourceChain(strategyState, start, opts) {
+    const maxDepth = opts?.maxDepth ?? 50;
+    const visited = new Set();
+    const path = [];
+    let current = start;
+    for (let depth = 0; depth <= maxDepth; depth++) {
+        path.push(current);
+        const visitKey = `${current.executionId}::${current.resourceRoleId}`;
+        if (visited.has(visitKey)) {
+            return { status: 'unresolved', reason: 'cycle', path };
+        }
+        visited.add(visitKey);
+        const bucket = strategyState[current.executionId];
+        if (!bucket)
+            return { status: 'unresolved', reason: 'missing-entry', path };
+        const entry = bucket[current.resourceRoleId];
+        if (!entry)
+            return { status: 'unresolved', reason: 'missing-entry', path };
+        if (entry.kind === 'materialized') {
+            return { status: 'materialized', entry: entry, path };
+        }
+        if (entry.kind === 'missing') {
+            return { status: 'missing', entry: entry, path };
+        }
+        if (entry.kind === 'potential-output') {
+            return { status: 'blocked-output', entry: entry, path };
+        }
+        // potential-input: follow ref backwards
+        if (entry.kind === 'potential-input') {
+            const rpi = entry.creationContext;
+            if (!rpi)
+                return { status: 'unresolved', reason: 'missing-entry', path };
+            current = rpi;
+            continue;
+        }
+        // Unknown case
+        return { status: 'unresolved', reason: 'missing-entry', path };
+    }
+    return { status: 'unresolved', reason: 'depth-exceeded', path };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toolproof-npm/shared",
-  "version": "0.1.50",
+  "version": "0.1.52",
   "description": "Core library utilities for ToolProof",
   "keywords": [
     "toolproof",
@@ -56,7 +56,7 @@
     "typescript": "^5.9.3"
   },
   "dependencies": {
-    "@toolproof-npm/schema": "^0.1.41",
+    "@toolproof-npm/schema": "^0.1.44",
     "firebase-admin": "^13.6.0"
   },
   "scripts": {