@toolproof-npm/shared 0.1.81 → 0.1.83

package/dist/_lib/types.d.ts

@@ -8,7 +8,3 @@ export type Role = {
     identity: ResourceRoleIdentityJson;
 } & ResourceRoleValueJson;
 export type ResourceMap = Record<ResourceTypeIdentityJson, ResourceJson[]>;
-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,5 +1,4 @@
 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
@@ -14,46 +13,21 @@ export declare function generateContentHash(content: string): string;
  */
 export declare function generateContentAddressedPath(resourceTypeRef: ResourceTypeIdentityJson, content: string): string;
 /**
- * Creates a materialized resource from a potential-output resource.
- * Converts the potential output to a materialized resource by generating a content-addressed path,
- * assigning the content as extractedData, and creating a timestamp.
+ * Creates a materialized resource from a potential-output resource and content.
+ * Generates a content-addressed path from the content.
  *
  * @param potentialOutput The potential-output resource to materialize
- * @param content The actual content produced by the job (assigned directly to extractedData)
- * @returns A fully materialized ResourceJson
- *
- * @example
- * ```typescript
- * const materialized = createMaterializedResourceFromPotentialOutput(
- *   potentialOutput,
- *   { identity: 42, someData: "result" }
- * );
- * ```
- */
-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 content and creates a timestamp.
- * Use this when creating resources manually without a potential-output template.
- *
- * @param partialResourceMeta Partial metadata (identity, type, context, optional timestamp)
  * @param content The actual content/data (assigned directly to extractedData)
+ * @param timestamp Optional timestamp to preserve (e.g., when copying resources). If not provided, generates a new timestamp.
  * @returns A fully materialized ResourceJson
  *
  * @example
  * ```typescript
- * const materialized = createMaterializedResourceFromScratch(
- *   {
- *     identity: 'RESOURCE-abc123',
- *     resourceTypeRef: 'TYPE-Natural',
- *     creationContext: {
- *       resourceRoleRef: 'ROLE-Manual',
- *       executionRef: 'EXECUTION-Genesis'
- *     },
- *     timestamp: '2025-01-03T12:00:00.000Z' // optional
- *   },
- *   { identity: 42 }
- * );
+ * // Materialize from potential output
+ * const materialized = createMaterializedResource(potentialOutput, { identity: 42 });
+ *
+ * // Preserve original timestamp when copying
+ * const copy = createMaterializedResource(potentialOutput, { identity: 42 }, originalTimestamp);
  * ```
  */
-export declare function createMaterializedResourceFromScratch(partialResourceMeta: PartialResourceMeta, content: JsonDataJson): ResourceJson;
+export declare function createMaterializedResource(potentialOutput: ResourcePotentialOutputJson, content: JsonDataJson, timestamp?: string): ResourceJson;

package/dist/_lib/utils/resourceCreation.js

@@ -18,65 +18,27 @@ export function generateContentAddressedPath(resourceTypeRef, content) {
     return `${resourceTypeRef}/${contentHash}`;
 }
 /**
- * Creates a materialized resource from a potential-output resource.
- * Converts the potential output to a materialized resource by generating a content-addressed path,
- * assigning the content as extractedData, and creating a timestamp.
+ * Creates a materialized resource from a potential-output resource and content.
+ * Generates a content-addressed path from the content.
  *
  * @param potentialOutput The potential-output resource to materialize
- * @param content The actual content produced by the job (assigned directly to extractedData)
- * @returns A fully materialized ResourceJson
- *
- * @example
- * ```typescript
- * const materialized = createMaterializedResourceFromPotentialOutput(
- *   potentialOutput,
- *   { identity: 42, someData: "result" }
- * );
- * ```
- */
-export function createMaterializedResourceFromPotentialOutput(potentialOutput, content) {
-    // Generate content-addressed path from the content
-    const contentString = JSON.stringify(content);
-    const path = generateContentAddressedPath(potentialOutput.resourceTypeRef, contentString);
-    return {
-        identity: potentialOutput.identity,
-        resourceTypeRef: potentialOutput.resourceTypeRef,
-        creationContext: potentialOutput.creationContext,
-        kind: 'materialized',
-        path,
-        timestamp: new Date().toISOString(),
-        extractedData: content,
-    };
-}
-/**
- * Creates a materialized resource from scratch (for manual resource creation).
- * Generates a content-addressed path from the content and creates a timestamp.
- * Use this when creating resources manually without a potential-output template.
- *
- * @param partialResourceMeta Partial metadata (identity, type, context, optional timestamp)
  * @param content The actual content/data (assigned directly to extractedData)
+ * @param timestamp Optional timestamp to preserve (e.g., when copying resources). If not provided, generates a new timestamp.
  * @returns A fully materialized ResourceJson
  *
  * @example
  * ```typescript
- * const materialized = createMaterializedResourceFromScratch(
- *   {
- *     identity: 'RESOURCE-abc123',
- *     resourceTypeRef: 'TYPE-Natural',
- *     creationContext: {
- *       resourceRoleRef: 'ROLE-Manual',
- *       executionRef: 'EXECUTION-Genesis'
- *     },
- *     timestamp: '2025-01-03T12:00:00.000Z' // optional
- *   },
- *   { identity: 42 }
- * );
+ * // Materialize from potential output
+ * const materialized = createMaterializedResource(potentialOutput, { identity: 42 });
+ *
+ * // Preserve original timestamp when copying
+ * const copy = createMaterializedResource(potentialOutput, { identity: 42 }, originalTimestamp);
  * ```
  */
-export function createMaterializedResourceFromScratch(partialResourceMeta, content) {
-    const { identity, resourceTypeRef, creationContext, timestamp } = partialResourceMeta;
-    // Generate content-addressed path from the content
-    const contentString = JSON.stringify(content);
+export function createMaterializedResource(potentialOutput, content, timestamp) {
+    const { identity, resourceTypeRef, creationContext } = potentialOutput;
+    // Generate content-addressed path from the content (use pretty-printed format)
+    const contentString = JSON.stringify(content, null, 2);
     const path = generateContentAddressedPath(resourceTypeRef, contentString);
     return {
         identity,

package/package.json

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