@toolproof-npm/shared 0.1.93 → 0.1.95

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

@@ -0,0 +1,3 @@
+import type { WorkStepJson, WhileStepJson, ForStepJson, JobJson } from '@toolproof-npm/schema';
+export declare const makeWorkStepFromJob: (job: JobJson) => Promise<WorkStepJson>;
+export declare const makeLoopStepFromJob: (job: JobJson, lessThanJob: JobJson, kind: "for" | "while") => Promise<ForStepJson | WhileStepJson>;

package/dist/_lib/utils/makeHelpers.js

@@ -0,0 +1,58 @@
+import { CONSTANTS } from '@toolproof-npm/shared/constants';
+import { getNewIdentity } from '@toolproof-npm/shared/server';
+// DOC: Helper function to construct an Execution object from a job
+const makeExecutionFromJob = async (job, executionRef) => {
+    const execIdentity = executionRef ?? await getNewIdentity(CONSTANTS.TERMINALS.execution);
+    const inputBindingMap = {};
+    const inputs = job.roles.inputMap;
+    await Promise.all(Object.keys(inputs).map(async (resourceRoleRef) => {
+        const resourceId = await getNewIdentity(CONSTANTS.TERMINALS.resource);
+        inputBindingMap[resourceRoleRef] = resourceId;
+    }));
+    const outputBindingMap = {};
+    const outputs = job.roles.outputMap;
+    await Promise.all(Object.keys(outputs).map(async (resourceRoleRef) => {
+        const resourceId = await getNewIdentity(CONSTANTS.TERMINALS.resource);
+        outputBindingMap[resourceRoleRef] = resourceId;
+    }));
+    return {
+        identity: execIdentity,
+        jobRef: job.identity,
+        roleBindings: {
+            inputBindingMap,
+            outputBindingMap
+        }
+    };
+};
+// DOC: Helper function to construct a WorkStep object from an jobMetaJson (does not append to statelessStrategy.steps)
+export const makeWorkStepFromJob = async (job) => {
+    const workStepIdentity = await getNewIdentity(CONSTANTS.STEPS.work);
+    const executionRef = workStepIdentity.replace(CONSTANTS.STEPS.work.toUpperCase(), 'execution'.toUpperCase()); // ATTENTION: use function
+    const execution = await makeExecutionFromJob(job, executionRef);
+    const newWorkStep = {
+        identity: workStepIdentity,
+        kind: CONSTANTS.STEPS.work,
+        execution
+    };
+    return newWorkStep;
+};
+// DOC: Helper function to construct a ForStep or WhileStep from a job
+export const makeLoopStepFromJob = async (job, lessThanJob, kind) => {
+    // Create the "what" WorkStep from the provided job
+    const whatWorkStep = await makeWorkStepFromJob(job);
+    // Create the "when" WorkStep from the LessThan job
+    const whenWorkStep = await makeWorkStepFromJob(lessThanJob);
+    // Generate loop step identity based on kind
+    const stepIdentity = (kind === 'for'
+        ? await getNewIdentity(CONSTANTS.STEPS.for)
+        : await getNewIdentity(CONSTANTS.STEPS.while));
+    // Assemble the loop step
+    return {
+        identity: stepIdentity,
+        kind,
+        case: {
+            what: whatWorkStep,
+            when: whenWorkStep
+        }
+    };
+};

package/dist/index.d.ts

@@ -2,5 +2,6 @@ export * as CONSTANTS from './constants.js';
 export * as TYPES from './_lib/types.js';
 export * as UTILS from './_lib/utils/utils.js';
 export * as RESOURCE_CREATION from './_lib/utils/resourceCreation.js';
+export * as MAKE_HELPERS from './_lib/utils/makeHelpers.js';
 export * from './firebaseAdminHelpers.js';
 export * from './firebaseAdminInit.js';

package/dist/index.js

@@ -2,5 +2,6 @@ export * as CONSTANTS from './constants.js';
 export * as TYPES from './_lib/types.js';
 export * as UTILS from './_lib/utils/utils.js';
 export * as RESOURCE_CREATION from './_lib/utils/resourceCreation.js';
+export * as MAKE_HELPERS from './_lib/utils/makeHelpers.js';
 export * from './firebaseAdminHelpers.js';
 export * from './firebaseAdminInit.js';

package/package.json

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