@blxzer/pactile 0.5.0

package/dist/pactile/middleware/manifest-loader.js

@@ -0,0 +1,228 @@
+import fs from "node:fs";
+import path from "node:path";
+import { parseProviderManifestV1, } from "@blxzer/pactile-core";
+export const PROVIDER_MANIFEST_LOAD_DIAGNOSTIC_CODES_V1 = [
+    "provider-root-unavailable",
+    "provider-root-case-collision",
+    "provider-directory-case-collision",
+    "provider-directory-unsupported",
+    "provider-manifest-count-exceeded",
+    "provider-manifest-case-collision",
+    "provider-manifest-entry-unsupported",
+    "provider-manifest-read-failed",
+    "provider-manifest-size-exceeded",
+    "provider-manifest-json-invalid",
+    "provider-manifest-contract-invalid",
+    "provider-manifest-sensitive-content",
+    "provider-manifest-duplicate",
+];
+const MAX_PROVIDER_MANIFESTS = 256;
+const MAX_PROVIDER_MANIFEST_BYTES = 1024 * 1024;
+const SAFE_MANIFEST_TERM = /^[a-z0-9]+(?:[._:-][a-z0-9]+)*$/;
+const SAFE_DESTINATION = /^[a-z0-9]+(?:[._-][a-z0-9]+)*(?::[0-9]+)?$/;
+const SENSITIVE_TERMS = new Set([
+    "credential",
+    "credentials",
+    "passwd",
+    "password",
+    "secret",
+    "token",
+]);
+function ordinalCompare(left, right) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+function foldedName(name) {
+    return name.normalize("NFC").toLowerCase();
+}
+function containsSensitiveTerm(value) {
+    return value
+        .replaceAll(":", ".")
+        .split(/[._-]/u)
+        .some((term) => SENSITIVE_TERMS.has(term));
+}
+function manifestStringsAreSafe(manifest) {
+    return (manifest.evidenceKinds.every((kind) => kind.length <= 128 &&
+        SAFE_MANIFEST_TERM.test(kind) &&
+        !containsSensitiveTerm(kind)) &&
+        manifest.policyCeiling.egressDestinations.every((destination) => destination.length <= 253 &&
+            SAFE_DESTINATION.test(destination) &&
+            !containsSensitiveTerm(destination)));
+}
+function fail(diagnostics) {
+    return { ok: false, manifests: [], diagnostics };
+}
+function directoryEntries(directory) {
+    try {
+        return fs.readdirSync(directory, { withFileTypes: true });
+    }
+    catch {
+        return null;
+    }
+}
+function exactDirectory(parent, expectedName, collisionCode, missingIsEmpty) {
+    const entries = directoryEntries(parent);
+    if (entries === null) {
+        return {
+            kind: "failed",
+            result: fail([
+                { code: "provider-root-unavailable", location: ".pactile" },
+            ]),
+        };
+    }
+    const matches = entries.filter((entry) => foldedName(entry.name) === foldedName(expectedName));
+    if (matches.length === 0) {
+        return missingIsEmpty
+            ? { kind: "empty" }
+            : {
+                kind: "failed",
+                result: fail([
+                    { code: "provider-directory-unsupported", location: expectedName },
+                ]),
+            };
+    }
+    const exact = matches.find((entry) => entry.name === expectedName);
+    if (matches.length !== 1 ||
+        exact === undefined ||
+        !exact.isDirectory() ||
+        exact.isSymbolicLink()) {
+        return {
+            kind: "failed",
+            result: fail([{ code: collisionCode, location: expectedName }]),
+        };
+    }
+    return { kind: "found", path: path.join(parent, expectedName) };
+}
+/**
+ * Read the exact `.pactile/providers/*.json` catalog without mutating it.
+ *
+ * Any malformed, unknown, duplicate, case-colliding, link-like, unreadable,
+ * or oversized entry invalidates the complete catalog. Diagnostics expose
+ * only stable ordinal locations and reason codes.
+ */
+export function loadProviderManifestsV1(projectRoot) {
+    if (typeof projectRoot !== "string" || projectRoot.length === 0) {
+        return fail([{ code: "provider-root-unavailable", location: ".pactile" }]);
+    }
+    const canonicalRoot = exactDirectory(projectRoot, ".pactile", "provider-root-case-collision", true);
+    if (canonicalRoot.kind === "empty") {
+        return { ok: true, manifests: [], diagnostics: [] };
+    }
+    if (canonicalRoot.kind === "failed")
+        return canonicalRoot.result;
+    const providers = exactDirectory(canonicalRoot.path, "providers", "provider-directory-case-collision", true);
+    if (providers.kind === "empty") {
+        return { ok: true, manifests: [], diagnostics: [] };
+    }
+    if (providers.kind === "failed")
+        return providers.result;
+    const unsortedEntries = directoryEntries(providers.path);
+    if (unsortedEntries === null) {
+        return fail([
+            {
+                code: "provider-directory-unsupported",
+                location: ".pactile/providers",
+            },
+        ]);
+    }
+    const entries = [...unsortedEntries].sort((left, right) => {
+        const folded = ordinalCompare(foldedName(left.name), foldedName(right.name));
+        return folded === 0 ? ordinalCompare(left.name, right.name) : folded;
+    });
+    if (entries.length > MAX_PROVIDER_MANIFESTS) {
+        return fail([
+            {
+                code: "provider-manifest-count-exceeded",
+                location: ".pactile/providers",
+            },
+        ]);
+    }
+    const diagnostics = [];
+    const seenNames = new Map();
+    const loaded = [];
+    entries.forEach((entry, index) => {
+        const location = `providers[${index}]`;
+        const folded = foldedName(entry.name);
+        if (seenNames.has(folded)) {
+            diagnostics.push({ code: "provider-manifest-case-collision", location });
+            return;
+        }
+        seenNames.set(folded, index);
+        if (!entry.isFile() ||
+            entry.isSymbolicLink() ||
+            !entry.name.endsWith(".json")) {
+            diagnostics.push({
+                code: "provider-manifest-entry-unsupported",
+                location,
+            });
+            return;
+        }
+        const manifestPath = path.join(providers.path, entry.name);
+        let bytes;
+        try {
+            const stat = fs.lstatSync(manifestPath);
+            if (!stat.isFile() || stat.isSymbolicLink()) {
+                diagnostics.push({
+                    code: "provider-manifest-entry-unsupported",
+                    location,
+                });
+                return;
+            }
+            if (stat.size > MAX_PROVIDER_MANIFEST_BYTES) {
+                diagnostics.push({ code: "provider-manifest-size-exceeded", location });
+                return;
+            }
+            bytes = fs.readFileSync(manifestPath);
+        }
+        catch {
+            diagnostics.push({ code: "provider-manifest-read-failed", location });
+            return;
+        }
+        let value;
+        try {
+            value = JSON.parse(bytes.toString("utf8"));
+        }
+        catch {
+            diagnostics.push({ code: "provider-manifest-json-invalid", location });
+            return;
+        }
+        const parsed = parseProviderManifestV1(value);
+        if (!parsed.success) {
+            diagnostics.push({
+                code: "provider-manifest-contract-invalid",
+                location,
+            });
+            return;
+        }
+        if (!manifestStringsAreSafe(parsed.data)) {
+            diagnostics.push({
+                code: "provider-manifest-sensitive-content",
+                location,
+            });
+            return;
+        }
+        loaded.push({ manifest: parsed.data, location });
+    });
+    const seenIdentities = new Set();
+    for (const item of loaded) {
+        const identity = `${item.manifest.id}\u0000${item.manifest.version}`;
+        if (seenIdentities.has(identity)) {
+            diagnostics.push({
+                code: "provider-manifest-duplicate",
+                location: item.location,
+            });
+        }
+        else {
+            seenIdentities.add(identity);
+        }
+    }
+    if (diagnostics.length > 0)
+        return fail(diagnostics);
+    return {
+        ok: true,
+        manifests: loaded
+            .map((item) => item.manifest)
+            .sort((left, right) => ordinalCompare(`${left.id}\u0000${left.version}`, `${right.id}\u0000${right.version}`)),
+        diagnostics: [],
+    };
+}
+//# sourceMappingURL=manifest-loader.js.map

package/dist/pactile/middleware/manifest-loader.js.map

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

package/dist/pactile/migration/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./transaction.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/pactile/migration/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/pactile/migration/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC"}

package/dist/pactile/migration/index.js

@@ -0,0 +1,2 @@
+export * from "./transaction.js";
+//# sourceMappingURL=index.js.map

package/dist/pactile/migration/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/pactile/migration/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC"}

package/dist/pactile/migration/transaction.d.ts

@@ -0,0 +1,54 @@
+import { type MigrationJournalV1, type MigrationPlanV1 } from "@blxzer/pactile-core";
+export type MigrationFileClassification = "active" | "closed" | "generated";
+export interface MigrationSourceFile {
+    readonly sourceRef: string;
+    readonly targetPath: string;
+    readonly classification: MigrationFileClassification;
+    readonly sourceBytes: Uint8Array;
+    readonly targetBytes: Uint8Array;
+    readonly expectedSourceFingerprint: string;
+}
+export interface MigrationTransactionRequest {
+    readonly projectRoot: string;
+    readonly id: string;
+    readonly generationId: string;
+    readonly sourceRoot: ".cstl" | ".trellis";
+    readonly sourceRuntimeVersion: string | null;
+    readonly sourceSchemaVersion: number | null;
+    readonly runtimeVersion: string;
+    readonly expectedInstallStateFingerprint: string | null;
+    readonly occurredAt: string;
+    readonly files: readonly MigrationSourceFile[];
+}
+export interface MigrationValidationContext {
+    readonly plan: MigrationPlanV1;
+    readonly generationId: string;
+    readonly files: readonly {
+        sourceRef: string;
+        targetPath: string;
+        classification: MigrationFileClassification;
+        fingerprint: string;
+    }[];
+}
+export interface MigrationTransactionOptions {
+    /** Additional schema validation at the public staged-generation boundary. */
+    readonly validateStaged?: (context: MigrationValidationContext) => boolean | Promise<boolean>;
+}
+export type MigrationTransactionResult = {
+    readonly status: "completed";
+    readonly resumed: boolean;
+    readonly plan: MigrationPlanV1;
+    readonly planFingerprint: string;
+    readonly journal: MigrationJournalV1;
+} | {
+    readonly status: "review" | "interrupted";
+    readonly reason: "invalid-migration-request" | "migration-plan-conflict" | "migration-validation-failed" | "migration-interrupted";
+    readonly plan: MigrationPlanV1 | null;
+    readonly journal: MigrationJournalV1 | null;
+};
+export declare function planMigrationTransaction(request: MigrationTransactionRequest): {
+    readonly plan: MigrationPlanV1;
+    readonly fingerprint: string;
+} | null;
+export declare function runMigrationTransaction(request: MigrationTransactionRequest, options?: MigrationTransactionOptions): Promise<MigrationTransactionResult>;
+//# sourceMappingURL=transaction.d.ts.map

package/dist/pactile/migration/transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../../../src/pactile/migration/transaction.ts"],"names":[],"mappings":"AAGA,OAAO,EAKL,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACrB,MAAM,sBAAsB,CAAC;AAQ9B,MAAM,MAAM,2BAA2B,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE5E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,2BAA2B,CAAC;IACrD,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC;IACjC,QAAQ,CAAC,yBAAyB,EAAE,MAAM,CAAC;CAC5C;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,OAAO,GAAG,UAAU,CAAC;IAC1C,QAAQ,CAAC,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7C,QAAQ,CAAC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,+BAA+B,EAAE,MAAM,GAAG,IAAI,CAAC;IACxD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;CAChD;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,SAAS;QACvB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,2BAA2B,CAAC;QAC5C,WAAW,EAAE,MAAM,CAAC;KACrB,EAAE,CAAC;CACL;AAED,MAAM,WAAW,2BAA2B;IAC1C,6EAA6E;IAC7E,QAAQ,CAAC,cAAc,CAAC,EAAE,CACxB,OAAO,EAAE,0BAA0B,KAChC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,MAAM,0BAA0B,GAClC;IACE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;CACtC,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,aAAa,CAAC;IAC1C,QAAQ,CAAC,MAAM,EACX,2BAA2B,GAC3B,yBAAyB,GACzB,6BAA6B,GAC7B,uBAAuB,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAC;CAC7C,CAAC;AAiFN,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,2BAA2B,GACnC;IAAE,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA8GzE;AA0ID,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,2BAA2B,EACpC,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,0BAA0B,CAAC,CA4NrC"}