rhachet-roles-ehmpathy 1.4.0 → 1.7.0

package/dist/contract/sdk/index.d.ts

@@ -1 +1,2 @@
 export { getRoleRegistry } from '../../logic/roles/getRoleRegistry';
+export { getInvokeHooks } from '../../logic/hooks/getInvokeHooks';

package/dist/contract/sdk/index.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getRoleRegistry = void 0;
+exports.getInvokeHooks = exports.getRoleRegistry = void 0;
 var getRoleRegistry_1 = require("../../logic/roles/getRoleRegistry");
 Object.defineProperty(exports, "getRoleRegistry", { enumerable: true, get: function () { return getRoleRegistry_1.getRoleRegistry; } });
+var getInvokeHooks_1 = require("../../logic/hooks/getInvokeHooks");
+Object.defineProperty(exports, "getInvokeHooks", { enumerable: true, get: function () { return getInvokeHooks_1.getInvokeHooks; } });
 //# sourceMappingURL=index.js.map

package/dist/contract/sdk/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/contract/sdk/index.ts"],"names":[],"mappings":";;;AAAA,qEAAoE;AAA3D,kHAAA,eAAe,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/contract/sdk/index.ts"],"names":[],"mappings":";;;AAAA,qEAAoE;AAA3D,kHAAA,eAAe,OAAA;AACxB,mEAAkE;AAAzD,gHAAA,cAAc,OAAA"}

package/dist/logic/hooks/decodeDocOutputPath.d.ts

@@ -0,0 +1,21 @@
+type DocVersions = {
+    variant: number | null;
+    instance: number | null;
+};
+type Decoded = {
+    prefix: string;
+    doctype: string;
+    versions: DocVersions;
+    extension: string | null;
+};
+/**
+ * parses a doc output path like:
+ *   ...persp_pro.v1i2.[stories].v1.i3.md
+ * into:
+ *   - doctype: "stories"
+ *   - prefix:  "...persp_pro.v1i2."
+ *   - versions: { variant: 1, instance: 3 }
+ *   - extension: "md"
+ */
+export declare const decodeDocOutputPath: (inputPath: string) => Decoded;
+export {};

package/dist/logic/hooks/decodeDocOutputPath.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decodeDocOutputPath = void 0;
+const helpful_errors_1 = require("helpful-errors");
+/**
+ * parses a doc output path like:
+ *   ...persp_pro.v1i2.[stories].v1.i3.md
+ * into:
+ *   - doctype: "stories"
+ *   - prefix:  "...persp_pro.v1i2."
+ *   - versions: { variant: 1, instance: 3 }
+ *   - extension: "md"
+ */
+const decodeDocOutputPath = (inputPath) => {
+    // find the LAST [doctype], where [doctype] cant be before a `/`
+    const lastDoctypeMatch = inputPath.match(/^(.*)\[(\w+)\]([^/]*)$/i);
+    if (!lastDoctypeMatch) {
+        throw new helpful_errors_1.BadRequestError('could not find any [doctype] in referenced path', { path: inputPath });
+    }
+    const beforeAndDot = lastDoctypeMatch[1]; // should end with the dot before [doctype], e.g., "...v1i2."
+    const doctype = lastDoctypeMatch[2]; // inside the brackets
+    const after = lastDoctypeMatch[3] || ''; // tail after the closing ]
+    // ensure prefix ends exactly before the bracket (without dot suffix, if any)
+    const prefix = beforeAndDot.endsWith('.')
+        ? beforeAndDot.slice(0, -1)
+        : beforeAndDot;
+    // parse tail tokens after the closing bracket, e.g. ".v1.i3.md", "._.md", ".md", etc.
+    // we’ll split on '.' and ignore empties so ".v1.i3.md" -> ["v1","i3","md"]
+    const tokens = after.split('.').filter(Boolean);
+    let variant = null;
+    let instance = null;
+    let extension = null;
+    for (const t of tokens) {
+        if (/^v\d+$/i.test(t)) {
+            variant = parseInt(t.slice(1), 10);
+            continue;
+        }
+        if (/^i\d+$/i.test(t)) {
+            instance = parseInt(t.slice(1), 10);
+            continue;
+        }
+        if (t === '_') {
+            // explicit “no attempt” marker – ignore for versions; not an extension
+            continue;
+        }
+        // anything else we treat as the extension; if multiple remain, the last wins
+        extension = t;
+    }
+    return {
+        prefix,
+        doctype,
+        versions: { variant, instance },
+        extension,
+    };
+};
+exports.decodeDocOutputPath = decodeDocOutputPath;
+//# sourceMappingURL=decodeDocOutputPath.js.map

package/dist/logic/hooks/decodeDocOutputPath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decodeDocOutputPath.js","sourceRoot":"","sources":["../../../src/logic/hooks/decodeDocOutputPath.ts"],"names":[],"mappings":";;;AAAA,mDAAiD;AAUjD;;;;;;;;GAQG;AACI,MAAM,mBAAmB,GAAG,CAAC,SAAiB,EAAW,EAAE;IAChE,gEAAgE;IAChE,MAAM,gBAAgB,GAAG,SAAS,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;IACpE,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,MAAM,IAAI,gCAAe,CACvB,iDAAiD,EACjD,EAAE,IAAI,EAAE,SAAS,EAAE,CACpB,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,gBAAgB,CAAC,CAAC,CAAE,CAAC,CAAC,6DAA6D;IACxG,MAAM,OAAO,GAAG,gBAAgB,CAAC,CAAC,CAAE,CAAC,CAAC,sBAAsB;IAC5D,MAAM,KAAK,GAAG,gBAAgB,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,2BAA2B;IAEpE,6EAA6E;IAC7E,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC;QACvC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3B,CAAC,CAAC,YAAY,CAAC;IAEjB,sFAAsF;IACtF,2EAA2E;IAC3E,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAEhD,IAAI,OAAO,GAAkB,IAAI,CAAC;IAClC,IAAI,QAAQ,GAAkB,IAAI,CAAC;IACnC,IAAI,SAAS,GAAkB,IAAI,CAAC;IAEpC,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACtB,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACnC,SAAS;QACX,CAAC;QACD,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACtB,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACpC,SAAS;QACX,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;YACd,uEAAuE;YACvE,SAAS;QACX,CAAC;QACD,6EAA6E;QAC7E,SAAS,GAAG,CAAC,CAAC;IAChB,CAAC;IAED,OAAO;QACL,MAAM;QACN,OAAO;QACP,QAAQ,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE;QAC/B,SAAS;KACV,CAAC;AACJ,CAAC,CAAC;AAlDW,QAAA,mBAAmB,uBAkD9B"}

package/dist/logic/hooks/decodeDocOutputPath.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/logic/hooks/decodeDocOutputPath.test.js

@@ -0,0 +1,146 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const helpful_errors_1 = require("helpful-errors");
+const test_fns_1 = require("test-fns");
+const decodeDocOutputPath_1 = require("./decodeDocOutputPath");
+describe('decodeDocOutputPath (only considers [doctype]s after the last "/")', () => {
+    (0, test_fns_1.given)('a typical path with [doctype] after the last slash', () => {
+        const input = 'src/product/protools/tool.routecal/step_5.stories/step_1.translate/' +
+            'provider.plumber_pete.customer_needs.scene_6.loyalty_build.persp_pro.v1i2.[stories].v1.i3.md';
+        (0, test_fns_1.when)('decoding the path', () => {
+            const result = (0, decodeDocOutputPath_1.decodeDocOutputPath)(input);
+            (0, test_fns_1.then)('it returns the expected fields', () => {
+                expect(result).toEqual({
+                    doctype: 'stories',
+                    prefix: 'src/product/protools/tool.routecal/step_5.stories/step_1.translate/' +
+                        'provider.plumber_pete.customer_needs.scene_6.loyalty_build.persp_pro.v1i2',
+                    versions: { variant: 1, instance: 3 },
+                    extension: 'md',
+                });
+            });
+        });
+    });
+    (0, test_fns_1.given)('multiple [doctype] segments exists, but only those after the last slash count', () => {
+        // two doctypes before the last slash, one after it
+        const input = 'root/alpha.[draft].beta/gamma.[notes].delta/' + // ignored doctypes (before last slash)
+            'omega.v2.[stories].i7.md'; // the only considered doctype
+        (0, test_fns_1.when)('decoding the path', () => {
+            const result = (0, decodeDocOutputPath_1.decodeDocOutputPath)(input);
+            (0, test_fns_1.then)('it uses the [doctype] after the last slash', () => {
+                expect(result.doctype).toBe('stories');
+                expect(result.prefix).toBe('root/alpha.[draft].beta/gamma.[notes].delta/omega.v2');
+                expect(result.versions).toEqual({ variant: null, instance: 7 });
+                expect(result.extension).toBe('md');
+            });
+        });
+    });
+    (0, test_fns_1.given)('no [doctype] appears after the last slash', () => {
+        const input = 'a/b/c/topic.[stories]/omega.v2.i7.md'; // [stories] is before the last slash
+        (0, test_fns_1.when)('decoding the path', () => {
+            const err = (0, test_fns_1.getError)(() => (0, decodeDocOutputPath_1.decodeDocOutputPath)(input));
+            (0, test_fns_1.then)('it throws a BadRequestError', () => {
+                expect(err).toBeInstanceOf(helpful_errors_1.BadRequestError);
+                expect(err.message).toMatch(/could not find any \[doctype]/i);
+            });
+        });
+    });
+    (0, test_fns_1.given)('multiple [doctype]s appear after the last slash (take the last one)', () => {
+        const input = 'a/b/c/topic.[draft].x.[stories].v1.md'; // both doctypes after last slash
+        (0, test_fns_1.when)('decoding the path', () => {
+            const result = (0, decodeDocOutputPath_1.decodeDocOutputPath)(input);
+            (0, test_fns_1.then)('it picks the last [doctype] after the last slash', () => {
+                expect(result).toEqual({
+                    doctype: 'stories',
+                    prefix: 'a/b/c/topic.[draft].x',
+                    versions: { variant: 1, instance: null },
+                    extension: 'md',
+                });
+            });
+        });
+    });
+    (0, test_fns_1.given)('a path with only variant after the doctype (post-last-slash)', () => {
+        const input = 'x/y/z/foo.[story].v12.md';
+        (0, test_fns_1.when)('decoding the path', () => {
+            const result = (0, decodeDocOutputPath_1.decodeDocOutputPath)(input);
+            (0, test_fns_1.then)('it parses variant and leaves instance null', () => {
+                expect(result).toEqual({
+                    doctype: 'story',
+                    prefix: 'x/y/z/foo',
+                    versions: { variant: 12, instance: null },
+                    extension: 'md',
+                });
+            });
+        });
+    });
+    (0, test_fns_1.given)('a path with only instance after the doctype (post-last-slash)', () => {
+        const input = 'x/y/z/foo.[story].i9.md';
+        (0, test_fns_1.when)('decoding the path', () => {
+            const result = (0, decodeDocOutputPath_1.decodeDocOutputPath)(input);
+            (0, test_fns_1.then)('it parses instance and leaves variant null', () => {
+                expect(result).toEqual({
+                    doctype: 'story',
+                    prefix: 'x/y/z/foo',
+                    versions: { variant: null, instance: 9 },
+                    extension: 'md',
+                });
+            });
+        });
+    });
+    (0, test_fns_1.given)('a path with explicit no-attempt marker "._" and an extension (post-last-slash)', () => {
+        const input = 'a/b/c/topic.[stories]._.md';
+        (0, test_fns_1.when)('decoding the path', () => {
+            const result = (0, decodeDocOutputPath_1.decodeDocOutputPath)(input);
+            (0, test_fns_1.then)('it ignores "_" for versions and still captures the extension', () => {
+                expect(result).toEqual({
+                    doctype: 'stories',
+                    prefix: 'a/b/c/topic',
+                    versions: { variant: null, instance: null },
+                    extension: 'md',
+                });
+            });
+        });
+    });
+    (0, test_fns_1.given)('a path with no extension after the doctype and versions (post-last-slash)', () => {
+        const input = 'a/b/c/topic.[stories].v3.i2';
+        (0, test_fns_1.when)('decoding the path', () => {
+            const result = (0, decodeDocOutputPath_1.decodeDocOutputPath)(input);
+            (0, test_fns_1.then)('it sets extension to null', () => {
+                expect(result).toEqual({
+                    doctype: 'stories',
+                    prefix: 'a/b/c/topic',
+                    versions: { variant: 3, instance: 2 },
+                    extension: null,
+                });
+            });
+        });
+    });
+    (0, test_fns_1.given)('a path with only an extension immediately after the doctype (post-last-slash)', () => {
+        const input = 'a/b/c/topic.[stories].md';
+        (0, test_fns_1.when)('decoding the path', () => {
+            const result = (0, decodeDocOutputPath_1.decodeDocOutputPath)(input);
+            (0, test_fns_1.then)('it returns no versions and the extension', () => {
+                expect(result).toEqual({
+                    doctype: 'stories',
+                    prefix: 'a/b/c/topic',
+                    versions: { variant: null, instance: null },
+                    extension: 'md',
+                });
+            });
+        });
+    });
+    (0, test_fns_1.given)('case-insensitive markers still parse (post-last-slash)', () => {
+        const input = 'a/b/c/topic.[STORIES].V10.I4.MD';
+        (0, test_fns_1.when)('decoding the path', () => {
+            const result = (0, decodeDocOutputPath_1.decodeDocOutputPath)(input);
+            (0, test_fns_1.then)('it parses regardless of case', () => {
+                expect(result).toEqual({
+                    doctype: 'STORIES',
+                    prefix: 'a/b/c/topic',
+                    versions: { variant: 10, instance: 4 },
+                    extension: 'MD',
+                });
+            });
+        });
+    });
+});
+//# sourceMappingURL=decodeDocOutputPath.test.js.map

package/dist/logic/hooks/decodeDocOutputPath.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decodeDocOutputPath.test.js","sourceRoot":"","sources":["../../../src/logic/hooks/decodeDocOutputPath.test.ts"],"names":[],"mappings":";;AAAA,mDAAiD;AACjD,uCAAuD;AAEvD,+DAA4D;AAE5D,QAAQ,CAAC,oEAAoE,EAAE,GAAG,EAAE;IAClF,IAAA,gBAAK,EAAC,oDAAoD,EAAE,GAAG,EAAE;QAC/D,MAAM,KAAK,GACT,qEAAqE;YACrE,8FAA8F,CAAC;QAEjG,IAAA,eAAI,EAAC,mBAAmB,EAAE,GAAG,EAAE;YAC7B,MAAM,MAAM,GAAG,IAAA,yCAAmB,EAAC,KAAK,CAAC,CAAC;YAE1C,IAAA,eAAI,EAAC,gCAAgC,EAAE,GAAG,EAAE;gBAC1C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;oBACrB,OAAO,EAAE,SAAS;oBAClB,MAAM,EACJ,qEAAqE;wBACrE,2EAA2E;oBAC7E,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE;oBACrC,SAAS,EAAE,IAAI;iBAChB,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAA,gBAAK,EACH,+EAA+E,EAC/E,GAAG,EAAE;QACH,mDAAmD;QACnD,MAAM,KAAK,GACT,8CAA8C,GAAG,uCAAuC;YACxF,0BAA0B,CAAC,CAAC,8BAA8B;QAE5D,IAAA,eAAI,EAAC,mBAAmB,EAAE,GAAG,EAAE;YAC7B,MAAM,MAAM,GAAG,IAAA,yCAAmB,EAAC,KAAK,CAAC,CAAC;YAE1C,IAAA,eAAI,EAAC,4CAA4C,EAAE,GAAG,EAAE;gBACtD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACvC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CACxB,sDAAsD,CACvD,CAAC;gBACF,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;gBAChE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtC,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CACF,CAAC;IAEF,IAAA,gBAAK,EAAC,2CAA2C,EAAE,GAAG,EAAE;QACtD,MAAM,KAAK,GAAG,sCAAsC,CAAC,CAAC,qCAAqC;QAE3F,IAAA,eAAI,EAAC,mBAAmB,EAAE,GAAG,EAAE;YAC7B,MAAM,GAAG,GAAG,IAAA,mBAAQ,EAAC,GAAG,EAAE,CAAC,IAAA,yCAAmB,EAAC,KAAK,CAAC,CAAC,CAAC;YAEvD,IAAA,eAAI,EAAC,6BAA6B,EAAE,GAAG,EAAE;gBACvC,MAAM,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC,gCAAe,CAAC,CAAC;gBAC5C,MAAM,CAAE,GAAuB,CAAC,OAAO,CAAC,CAAC,OAAO,CAC9C,gCAAgC,CACjC,CAAC;YACJ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAA,gBAAK,EACH,qEAAqE,EACrE,GAAG,EAAE;QACH,MAAM,KAAK,GAAG,uCAAuC,CAAC,CAAC,iCAAiC;QAExF,IAAA,eAAI,EAAC,mBAAmB,EAAE,GAAG,EAAE;YAC7B,MAAM,MAAM,GAAG,IAAA,yCAAmB,EAAC,KAAK,CAAC,CAAC;YAE1C,IAAA,eAAI,EAAC,kDAAkD,EAAE,GAAG,EAAE;gBAC5D,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;oBACrB,OAAO,EAAE,SAAS;oBAClB,MAAM,EAAE,uBAAuB;oBAC/B,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE;oBACxC,SAAS,EAAE,IAAI;iBAChB,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CACF,CAAC;IAEF,IAAA,gBAAK,EAAC,8DAA8D,EAAE,GAAG,EAAE;QACzE,MAAM,KAAK,GAAG,0BAA0B,CAAC;QAEzC,IAAA,eAAI,EAAC,mBAAmB,EAAE,GAAG,EAAE;YAC7B,MAAM,MAAM,GAAG,IAAA,yCAAmB,EAAC,KAAK,CAAC,CAAC;YAE1C,IAAA,eAAI,EAAC,4CAA4C,EAAE,GAAG,EAAE;gBACtD,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;oBACrB,OAAO,EAAE,OAAO;oBAChB,MAAM,EAAE,WAAW;oBACnB,QAAQ,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;oBACzC,SAAS,EAAE,IAAI;iBAChB,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAA,gBAAK,EAAC,+DAA+D,EAAE,GAAG,EAAE;QAC1E,MAAM,KAAK,GAAG,yBAAyB,CAAC;QAExC,IAAA,eAAI,EAAC,mBAAmB,EAAE,GAAG,EAAE;YAC7B,MAAM,MAAM,GAAG,IAAA,yCAAmB,EAAC,KAAK,CAAC,CAAC;YAE1C,IAAA,eAAI,EAAC,4CAA4C,EAAE,GAAG,EAAE;gBACtD,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;oBACrB,OAAO,EAAE,OAAO;oBAChB,MAAM,EAAE,WAAW;oBACnB,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE;oBACxC,SAAS,EAAE,IAAI;iBAChB,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAA,gBAAK,EACH,gFAAgF,EAChF,GAAG,EAAE;QACH,MAAM,KAAK,GAAG,4BAA4B,CAAC;QAE3C,IAAA,eAAI,EAAC,mBAAmB,EAAE,GAAG,EAAE;YAC7B,MAAM,MAAM,GAAG,IAAA,yCAAmB,EAAC,KAAK,CAAC,CAAC;YAE1C,IAAA,eAAI,EACF,8DAA8D,EAC9D,GAAG,EAAE;gBACH,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;oBACrB,OAAO,EAAE,SAAS;oBAClB,MAAM,EAAE,aAAa;oBACrB,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;oBAC3C,SAAS,EAAE,IAAI;iBAChB,CAAC,CAAC;YACL,CAAC,CACF,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC,CACF,CAAC;IAEF,IAAA,gBAAK,EACH,2EAA2E,EAC3E,GAAG,EAAE;QACH,MAAM,KAAK,GAAG,6BAA6B,CAAC;QAE5C,IAAA,eAAI,EAAC,mBAAmB,EAAE,GAAG,EAAE;YAC7B,MAAM,MAAM,GAAG,IAAA,yCAAmB,EAAC,KAAK,CAAC,CAAC;YAE1C,IAAA,eAAI,EAAC,2BAA2B,EAAE,GAAG,EAAE;gBACrC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;oBACrB,OAAO,EAAE,SAAS;oBAClB,MAAM,EAAE,aAAa;oBACrB,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE;oBACrC,SAAS,EAAE,IAAI;iBAChB,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CACF,CAAC;IAEF,IAAA,gBAAK,EACH,+EAA+E,EAC/E,GAAG,EAAE;QACH,MAAM,KAAK,GAAG,0BAA0B,CAAC;QAEzC,IAAA,eAAI,EAAC,mBAAmB,EAAE,GAAG,EAAE;YAC7B,MAAM,MAAM,GAAG,IAAA,yCAAmB,EAAC,KAAK,CAAC,CAAC;YAE1C,IAAA,eAAI,EAAC,0CAA0C,EAAE,GAAG,EAAE;gBACpD,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;oBACrB,OAAO,EAAE,SAAS;oBAClB,MAAM,EAAE,aAAa;oBACrB,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;oBAC3C,SAAS,EAAE,IAAI;iBAChB,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CACF,CAAC;IAEF,IAAA,gBAAK,EAAC,wDAAwD,EAAE,GAAG,EAAE;QACnE,MAAM,KAAK,GAAG,iCAAiC,CAAC;QAEhD,IAAA,eAAI,EAAC,mBAAmB,EAAE,GAAG,EAAE;YAC7B,MAAM,MAAM,GAAG,IAAA,yCAAmB,EAAC,KAAK,CAAC,CAAC;YAE1C,IAAA,eAAI,EAAC,8BAA8B,EAAE,GAAG,EAAE;gBACxC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;oBACrB,OAAO,EAAE,SAAS;oBAClB,MAAM,EAAE,aAAa;oBACrB,QAAQ,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE;oBACtC,SAAS,EAAE,IAAI;iBAChB,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/logic/hooks/execTranslateDocOutputPath.d.ts

@@ -0,0 +1,20 @@
+import { ContextLogTrail } from 'as-procedure';
+import { InvokeOpts } from 'rhachet';
+/**
+ * .what = execute the translation of a doc output path
+ * .why =
+ *   - given @translate(references.1)
+ *   - then, want to apply a standard transformation onto it
+ * .how =
+ *   - .[doctype] replaced
+ *   - .vNiN trail markers preserved as prefix before .[doctype]
+ *   - .v1 always started with, to facilitate subsequent trails
+ *   - .rel(...) optionally re-roots the prefix directory relatively
+ */
+export declare const execTranslateDocOutputPath: (opts: InvokeOpts<{
+    ask: string;
+    config: string;
+}>, context?: ContextLogTrail) => InvokeOpts<{
+    ask: string;
+    config: string;
+}>;

package/dist/logic/hooks/execTranslateDocOutputPath.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.execTranslateDocOutputPath = void 0;
+const helpful_errors_1 = require("helpful-errors");
+const type_fns_1 = require("type-fns");
+const decodeDocOutputPath_1 = require("./decodeDocOutputPath");
+const relateDocOutputPath_1 = require("./relateDocOutputPath");
+/**
+ * .what = execute the translation of a doc output path
+ * .why =
+ *   - given @translate(references.1)
+ *   - then, want to apply a standard transformation onto it
+ * .how =
+ *   - .[doctype] replaced
+ *   - .vNiN trail markers preserved as prefix before .[doctype]
+ *   - .v1 always started with, to facilitate subsequent trails
+ *   - .rel(...) optionally re-roots the prefix directory relatively
+ */
+const execTranslateDocOutputPath = (opts, context) => {
+    // if no .output or not a string, nothing to do
+    if (typeof opts.output !== 'string')
+        return opts;
+    // if not starts with @translate(, nothing to do
+    if (!opts.output.startsWith('@translate('))
+        return opts;
+    // if not @translate(references.0), fail fast
+    if (!opts.output.startsWith('@translate(references.0)'))
+        throw new helpful_errors_1.BadRequestError('unsupported @translation source. today, only "references.0" is supported', { opts });
+    // grab the "as" doctype, from @translate(references.0).as(doctype)
+    const doctypeAs = opts.output.match(/\.as\(([^)]+)\)/i)?.[1] ??
+        helpful_errors_1.UnexpectedCodePathError.throw('.as(doctype) was not part of output. can not translate', { opts });
+    // grab the extension override, if specified
+    const extensionOverride = opts.output.match(/\.ext\(([^)]+)\)/i)?.[1] ?? null;
+    // optional: starting variant override via .v(n)
+    const startVariantStr = opts.output.match(/\.v\((\d+)\)/i)?.[1] ?? null;
+    const startVariant = startVariantStr === null ? 1 : Number.parseInt(startVariantStr, 10);
+    if (!Number.isInteger(startVariant) || startVariant < 1) {
+        throw new helpful_errors_1.BadRequestError('.v(n) must be a positive integer (e.g. .v(2))', {
+            opts,
+            startVariantStr,
+        });
+    }
+    // grab the optional relative directory augmenter, e.g. .rel(../step_2.format)
+    const relAugment = opts.output
+        .match(/\.rel\(([^)]+)\)/i)?.[1]
+        ?.trim()
+        .replace(/^['"]|['"]$/g, '') ?? null;
+    // verify that references.0 exists and extract it
+    const inputPath = (() => {
+        if (typeof opts.references !== 'string')
+            throw new helpful_errors_1.BadRequestError('opts.references is not a string', { opts });
+        return (opts.references.split(',')[0] ||
+            helpful_errors_1.BadRequestError.throw('opts.references is not a string', { opts }));
+    })();
+    // attempt to grab doctype and versions from it
+    const { prefix, versions, extension } = (0, decodeDocOutputPath_1.decodeDocOutputPath)(inputPath);
+    // compose new output path
+    const outputPath = [
+        prefix,
+        versions.variant || versions.instance
+            ? [
+                versions.variant ? `v${versions.variant}` : '',
+                versions.instance ? `i${versions.instance}` : '',
+            ].join('')
+            : null,
+        `[${doctypeAs}]`,
+        `v${startVariant}`,
+        extensionOverride ?? extension,
+    ]
+        .filter(type_fns_1.isPresent)
+        .join('.');
+    // relate the output path, if requested
+    const outputPathRelated = relAugment
+        ? (0, relateDocOutputPath_1.relateDocOutputPath)({ path: outputPath, relation: relAugment })
+        : outputPath;
+    // swap out the opts
+    return { ...opts, output: outputPathRelated };
+};
+exports.execTranslateDocOutputPath = execTranslateDocOutputPath;
+//# sourceMappingURL=execTranslateDocOutputPath.js.map

package/dist/logic/hooks/execTranslateDocOutputPath.js.map

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

package/dist/logic/hooks/execTranslateDocOutputPath.test.d.ts

@@ -0,0 +1 @@
+export {};