@toolproof-npm/shared 0.1.79 → 0.1.81

package/dist/_lib/types.d.ts

@@ -1,4 +1,4 @@
-import type { ExecutionIdentityJson, ResourceIdentityJson, ResourceJson, ResourceRoleIdentityJson, ResourceRoleValueJson, ResourceTypeIdentityJson } from '@toolproof-npm/schema';
+import type { ResourceJson, ResourceRoleIdentityJson, ResourceRoleValueJson, ResourceTypeIdentityJson } from '@toolproof-npm/schema';
 import { CONSTANTS } from '../constants.js';
 export type BucketConst = typeof CONSTANTS.STORAGE.BUCKETS.tp_resources;
 export type CollectionConst = keyof typeof CONSTANTS.STORAGE.COLLECTIONS;
@@ -8,12 +8,7 @@ export type Role = {
     identity: ResourceRoleIdentityJson;
 } & ResourceRoleValueJson;
 export type ResourceMap = Record<ResourceTypeIdentityJson, ResourceJson[]>;
-export type PartialResourceMeta = {
-    identity: ResourceIdentityJson;
-    resourceTypeRef: ResourceTypeIdentityJson;
-    creationContext: {
-        resourceRoleRef: ResourceRoleIdentityJson;
-        executionRef: ExecutionIdentityJson;
-    };
+export type PartialResourceMeta = Omit<ResourceJson, 'kind' | 'timestamp' | 'path' | 'extractedData'> & {
+    /** Optional timestamp (for replacing existing resources with same timestamp) */
     timestamp?: string;
 };

package/dist/_lib/utils/resourceCreation.d.ts

@@ -1,4 +1,5 @@
 import type { ResourceTypeIdentityJson, ResourceJson, ResourcePotentialOutputJson, JsonDataJson } from '@toolproof-npm/schema';
+import type { PartialResourceMeta } from '../types.js';
 /**
  * Generates SHA-256 hash of content
  * @param content The content to hash
@@ -12,14 +13,6 @@ export declare function generateContentHash(content: string): string;
  * @returns The path in format: {resourceTypeRef}/{contentHash}
  */
 export declare function generateContentAddressedPath(resourceTypeRef: ResourceTypeIdentityJson, content: string): string;
-/**
- * Options for creating a materialized resource from scratch
- * Omits 'kind' (always set to 'materialized'), 'path' (auto-generated), and makes 'timestamp' optional
- */
-export type CreateMaterializedResourceFromScratchOptions = Omit<ResourceJson, 'kind' | 'timestamp' | 'path'> & {
-    /** Optional timestamp (for replacing existing resources with same timestamp) */
-    timestamp?: string;
-};
 /**
  * Creates a materialized resource from a potential-output resource.
  * Converts the potential output to a materialized resource by generating a content-addressed path,
@@ -40,24 +33,27 @@ export type CreateMaterializedResourceFromScratchOptions = Omit<ResourceJson, 'k
 export declare function createMaterializedResourceFromPotentialOutput(potentialOutput: ResourcePotentialOutputJson, content: JsonDataJson): ResourceJson;
 /**
  * Creates a materialized resource from scratch (for manual resource creation).
- * Generates a content-addressed path from the extractedData and creates a timestamp.
+ * Generates a content-addressed path from the content and creates a timestamp.
  * Use this when creating resources manually without a potential-output template.
  *
- * @param options All required fields for creating a materialized resource
+ * @param partialResourceMeta Partial metadata (identity, type, context, optional timestamp)
+ * @param content The actual content/data (assigned directly to extractedData)
  * @returns A fully materialized ResourceJson
  *
  * @example
  * ```typescript
- * const materialized = createMaterializedResourceFromScratch({
- *   identity: 'RESOURCE-abc123',
- *   resourceTypeRef: 'TYPE-Natural',
- *   creationContext: {
- *     resourceRoleRef: 'ROLE-Manual',
- *     executionRef: 'EXECUTION-Genesis'
+ * const materialized = createMaterializedResourceFromScratch(
+ *   {
+ *     identity: 'RESOURCE-abc123',
+ *     resourceTypeRef: 'TYPE-Natural',
+ *     creationContext: {
+ *       resourceRoleRef: 'ROLE-Manual',
+ *       executionRef: 'EXECUTION-Genesis'
+ *     },
+ *     timestamp: '2025-01-03T12:00:00.000Z' // optional
  *   },
- *   extractedData: { identity: 42 },
- *   timestamp: '2025-01-03T12:00:00.000Z' // optional
- * });
+ *   { identity: 42 }
+ * );
  * ```
  */
-export declare function createMaterializedResourceFromScratch(options: CreateMaterializedResourceFromScratchOptions): ResourceJson;
+export declare function createMaterializedResourceFromScratch(partialResourceMeta: PartialResourceMeta, content: JsonDataJson): ResourceJson;

package/dist/_lib/utils/resourceCreation.js

@@ -50,30 +50,33 @@ export function createMaterializedResourceFromPotentialOutput(potentialOutput, c
 }
 /**
  * Creates a materialized resource from scratch (for manual resource creation).
- * Generates a content-addressed path from the extractedData and creates a timestamp.
+ * Generates a content-addressed path from the content and creates a timestamp.
  * Use this when creating resources manually without a potential-output template.
  *
- * @param options All required fields for creating a materialized resource
+ * @param partialResourceMeta Partial metadata (identity, type, context, optional timestamp)
+ * @param content The actual content/data (assigned directly to extractedData)
  * @returns A fully materialized ResourceJson
  *
  * @example
  * ```typescript
- * const materialized = createMaterializedResourceFromScratch({
- *   identity: 'RESOURCE-abc123',
- *   resourceTypeRef: 'TYPE-Natural',
- *   creationContext: {
- *     resourceRoleRef: 'ROLE-Manual',
- *     executionRef: 'EXECUTION-Genesis'
+ * const materialized = createMaterializedResourceFromScratch(
+ *   {
+ *     identity: 'RESOURCE-abc123',
+ *     resourceTypeRef: 'TYPE-Natural',
+ *     creationContext: {
+ *       resourceRoleRef: 'ROLE-Manual',
+ *       executionRef: 'EXECUTION-Genesis'
+ *     },
+ *     timestamp: '2025-01-03T12:00:00.000Z' // optional
  *   },
- *   extractedData: { identity: 42 },
- *   timestamp: '2025-01-03T12:00:00.000Z' // optional
- * });
+ *   { identity: 42 }
+ * );
  * ```
  */
-export function createMaterializedResourceFromScratch(options) {
-    const { identity, resourceTypeRef, creationContext, extractedData, timestamp } = options;
-    // Generate content-addressed path from the extractedData
-    const contentString = JSON.stringify(extractedData);
+export function createMaterializedResourceFromScratch(partialResourceMeta, content) {
+    const { identity, resourceTypeRef, creationContext, timestamp } = partialResourceMeta;
+    // Generate content-addressed path from the content
+    const contentString = JSON.stringify(content);
     const path = generateContentAddressedPath(resourceTypeRef, contentString);
     return {
         identity,
@@ -82,6 +85,6 @@ export function createMaterializedResourceFromScratch(options) {
         kind: 'materialized',
         path,
         timestamp: timestamp ?? new Date().toISOString(),
-        extractedData,
+        extractedData: content,
     };
 }

package/dist/constants.d.ts

@@ -19,7 +19,7 @@ export declare const CONSTANTS: {
         readonly type: "type";
         readonly role: "role";
         readonly job: "job";
-        readonly execution: "executions";
+        readonly execution: "execution";
         readonly resource: "resource";
         readonly stateless_strategy: "stateless_strategy";
         readonly stateful_strategy: "stateful_strategy";

package/dist/constants.js

@@ -19,7 +19,7 @@ export const CONSTANTS = {
         type: 'type',
         role: 'role',
         job: 'job',
-        execution: 'executions',
+        execution: 'execution',
         resource: 'resource',
         stateless_strategy: 'stateless_strategy',
         stateful_strategy: 'stateful_strategy',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toolproof-npm/shared",
-  "version": "0.1.79",
+  "version": "0.1.81",
   "description": "Core library utilities for ToolProof",
   "keywords": [
     "toolproof",