@indigoai-us/hq-cloud 6.18.16 → 6.18.17

package/dist/plan-limit.fixtures.js

@@ -0,0 +1,96 @@
+/**
+ * Plan-limit refusal bodies as the vault service sends them, for tests.
+ *
+ * `canonicalPlanLimitBody` mirrors the hard-stop 402 body the server builds
+ * for a Starter company over storage (`error`, `status`, `blocked`,
+ * `resources`, `message`, `fixOptions`, `freeMonth`, `upgradeUrl`) plus the
+ * `code: "PLAN_LIMIT_EXCEEDED"` older clients key on. The other bodies are
+ * the legacy and per-item shapes clients must keep accepting.
+ */
+export const PLAN_LIMIT_UPGRADE_URL = "https://billing.example.test/companies/acme/billing";
+/** Starter storage limit (10 GiB) and a usage over it. */
+const STORAGE_LIMIT = 10_737_418_240;
+const STORAGE_USED = 11_811_160_064;
+/** The canonical HTTP 402 hard-stop body for a company over storage. */
+export function canonicalPlanLimitBody() {
+    return {
+        error: "plan_limit_reached",
+        code: "PLAN_LIMIT_EXCEEDED",
+        status: 402,
+        blocked: "files.create",
+        resources: [
+            { resource: "storageBytes", used: STORAGE_USED, limit: STORAGE_LIMIT },
+        ],
+        message: "New files are paused while Acme is over its Starter limits.",
+        fixOptions: { storageBytes: STORAGE_LIMIT },
+        freeMonth: {
+            eligible: true,
+            trialDays: 30,
+            url: "https://billing.example.test/companies/acme/billing?offer=free-month",
+        },
+        upgradeUrl: PLAN_LIMIT_UPGRADE_URL,
+    };
+}
+/** The legacy membership 402 (seat limit). */
+export function legacyMembershipPlanLimitBody() {
+    return {
+        code: "PLAN_LIMIT_EXCEEDED",
+        resource: "users",
+        used: 5,
+        limit: 5,
+        requiredPlan: "team",
+        upgradeUrl: PLAN_LIMIT_UPGRADE_URL,
+    };
+}
+/** A per-item personal-scope presign refusal row. */
+export function personalPresignRefusalRow(key) {
+    return {
+        key,
+        op: "put",
+        error: `${key} was not uploaded: your personal vault is over its plan limit.`,
+        code: "PLAN_LIMIT_REACHED",
+        upgradeUrl: PLAN_LIMIT_UPGRADE_URL,
+    };
+}
+/**
+ * A per-item company presign refusal row, exactly as the server builds it
+ * (`companyPresignRefusalItemError` in the presign handler): the refusal
+ * sentence in `error`, the legacy `PLAN_LIMIT_EXCEEDED` code and the upgrade
+ * link. The server sends it only for the puts of a MIXED batch; a put-only
+ * batch gets the whole-batch 402 body instead.
+ */
+export function companyPresignRefusalRow(key) {
+    const body = canonicalPlanLimitBody();
+    return {
+        key,
+        op: "put",
+        error: body.message,
+        code: body.code,
+        upgradeUrl: body.upgradeUrl,
+    };
+}
+/** The admission check's answer when the company is under its limits. */
+export function admissionAllowedBody() {
+    return { allowed: true };
+}
+/**
+ * Today's production answer to an admission body on a presign route that
+ * predates the admission check: the body names no `company`, so it is a 400.
+ */
+export function admissionUnsupportedBody() {
+    return { error: "Pass either `personal: true` or `company`" };
+}
+/** Mutation-prepare's HTTP 200 skip body. */
+export function mutationPrepareSkippedBody() {
+    const body = canonicalPlanLimitBody();
+    return {
+        skipped: true,
+        code: "PLAN_LIMIT_REACHED",
+        message: "notes/a.md was not uploaded: your personal vault is over its plan limit.",
+        error: body.error,
+        blocked: body.blocked,
+        resources: body.resources,
+        upgradeUrl: body.upgradeUrl,
+    };
+}
+//# sourceMappingURL=plan-limit.fixtures.js.map

package/dist/plan-limit.fixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-limit.fixtures.js","sourceRoot":"","sources":["../src/plan-limit.fixtures.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,CAAC,MAAM,sBAAsB,GACjC,qDAAqD,CAAC;AAExD,0DAA0D;AAC1D,MAAM,aAAa,GAAG,cAAc,CAAC;AACrC,MAAM,YAAY,GAAG,cAAc,CAAC;AAEpC,wEAAwE;AACxE,MAAM,UAAU,sBAAsB;IACpC,OAAO;QACL,KAAK,EAAE,oBAAoB;QAC3B,IAAI,EAAE,qBAAqB;QAC3B,MAAM,EAAE,GAAG;QACX,OAAO,EAAE,cAAc;QACvB,SAAS,EAAE;YACT,EAAE,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,aAAa,EAAE;SACvE;QACD,OAAO,EAAE,6DAA6D;QACtE,UAAU,EAAE,EAAE,YAAY,EAAE,aAAa,EAAE;QAC3C,SAAS,EAAE;YACT,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,EAAE;YACb,GAAG,EAAE,sEAAsE;SAC5E;QACD,UAAU,EAAE,sBAAsB;KACnC,CAAC;AACJ,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,6BAA6B;IAC3C,OAAO;QACL,IAAI,EAAE,qBAAqB;QAC3B,QAAQ,EAAE,OAAO;QACjB,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,CAAC;QACR,YAAY,EAAE,MAAM;QACpB,UAAU,EAAE,sBAAsB;KACnC,CAAC;AACJ,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,yBAAyB,CAAC,GAAW;IACnD,OAAO;QACL,GAAG;QACH,EAAE,EAAE,KAAK;QACT,KAAK,EAAE,GAAG,GAAG,gEAAgE;QAC7E,IAAI,EAAE,oBAAoB;QAC1B,UAAU,EAAE,sBAAsB;KACnC,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CAAC,GAAW;IAClD,MAAM,IAAI,GAAG,sBAAsB,EAAE,CAAC;IACtC,OAAO;QACL,GAAG;QACH,EAAE,EAAE,KAAK;QACT,KAAK,EAAE,IAAI,CAAC,OAAO;QACnB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,UAAU,EAAE,IAAI,CAAC,UAAU;KAC5B,CAAC;AACJ,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,oBAAoB;IAClC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB;IACtC,OAAO,EAAE,KAAK,EAAE,2CAA2C,EAAE,CAAC;AAChE,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,0BAA0B;IACxC,MAAM,IAAI,GAAG,sBAAsB,EAAE,CAAC;IACtC,OAAO;QACL,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,oBAAoB;QAC1B,OAAO,EAAE,0EAA0E;QACnF,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,UAAU,EAAE,IAAI,CAAC,UAAU;KAC5B,CAAC;AACJ,CAAC"}

package/dist/plan-limit.js

@@ -0,0 +1,157 @@
+/**
+ * One parser for every shape the vault service uses to refuse a write because
+ * the company (or personal vault) is over its plan limits.
+ *
+ * Shapes accepted:
+ *
+ *   1. The canonical hard-stop body, sent with HTTP 402:
+ *      `{ error: "plan_limit_reached", code: "PLAN_LIMIT_EXCEEDED", status: 402,
+ *         blocked, resources: [{ resource, used, limit }], message, fixOptions,
+ *         freeMonth?, upgradeUrl }`
+ *   2. The legacy membership 402:
+ *      `{ code: "PLAN_LIMIT_EXCEEDED", resource, used, limit, requiredPlan, upgradeUrl }`
+ *   3. A per-item presign row: `{ key, op, error, code: "PLAN_LIMIT_REACHED" |
+ *      "PLAN_LIMIT_EXCEEDED", upgradeUrl }`. Here `error` is either the machine
+ *      value `plan_limit_reached` or a human sentence.
+ *   4. The sync mutation-prepare skip, sent with HTTP 200:
+ *      `{ skipped: true, code, message, error, blocked, resources, upgradeUrl }`
+ *
+ * A body is a plan-limit refusal only when it carries a plan-limit marker
+ * (`error: "plan_limit_reached"`, or `code` of `PLAN_LIMIT_EXCEEDED` /
+ * `PLAN_LIMIT_REACHED`) and an `https:` `upgradeUrl`. The HTTP status alone
+ * never makes a body a plan-limit refusal: other 402s (billing, payment
+ * method) keep their own handling.
+ *
+ * This module has no imports so the vault client, the presign transport and
+ * the mutation client can all share it without a cycle.
+ */
+/** Machine `error` value of the canonical hard-stop body. */
+export const PLAN_LIMIT_REACHED_ERROR = "plan_limit_reached";
+/** Machine `code` values that mark a plan-limit refusal (current and legacy). */
+export const PLAN_LIMIT_CODES = new Set([
+    "PLAN_LIMIT_EXCEEDED",
+    "PLAN_LIMIT_REACHED",
+]);
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function nonEmptyString(value) {
+    return typeof value === "string" && value.trim() !== "" ? value : undefined;
+}
+function finiteNumber(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
+/**
+ * True for an absolute `https:` URL. Upgrade links are opened in a browser
+ * or printed for the user to click, so any other scheme is rejected.
+ */
+export function isHttpsUpgradeUrl(value) {
+    if (typeof value !== "string" || value.trim() === "")
+        return false;
+    try {
+        return new URL(value).protocol === "https:";
+    }
+    catch {
+        return false;
+    }
+}
+/** True when `error` or `code` names a plan-limit refusal. */
+export function hasPlanLimitMarker(fields) {
+    return (fields.error === PLAN_LIMIT_REACHED_ERROR ||
+        (typeof fields.code === "string" && PLAN_LIMIT_CODES.has(fields.code)));
+}
+function parseResources(body) {
+    if (Array.isArray(body.resources)) {
+        const rows = [];
+        for (const row of body.resources) {
+            if (!isRecord(row))
+                continue;
+            const resource = nonEmptyString(row.resource);
+            const used = finiteNumber(row.used);
+            const limit = finiteNumber(row.limit);
+            if (resource === undefined || used === undefined || limit === undefined)
+                continue;
+            rows.push({ resource, used, limit });
+        }
+        return rows.length > 0 ? rows : undefined;
+    }
+    // Legacy membership 402 carries one resource at the top level.
+    const resource = nonEmptyString(body.resource);
+    const used = finiteNumber(body.used);
+    const limit = finiteNumber(body.limit);
+    if (resource !== undefined && used !== undefined && limit !== undefined) {
+        return [{ resource, used, limit }];
+    }
+    return undefined;
+}
+function parseFixOptions(value) {
+    if (!isRecord(value))
+        return undefined;
+    const out = {};
+    for (const [key, raw] of Object.entries(value)) {
+        const n = finiteNumber(raw);
+        if (n !== undefined)
+            out[key] = n;
+    }
+    return Object.keys(out).length > 0 ? out : undefined;
+}
+/**
+ * Parse a response body (already JSON-decoded), a per-item presign row, or a
+ * stored refusal into a plan-limit refusal. Returns null unless the body has a
+ * plan-limit marker and an `https:` upgrade link.
+ */
+export function parsePlanLimitRefusal(body) {
+    if (!isRecord(body))
+        return null;
+    if (!hasPlanLimitMarker(body))
+        return null;
+    const upgradeUrl = body.upgradeUrl;
+    if (!isHttpsUpgradeUrl(upgradeUrl))
+        return null;
+    const refusal = { upgradeUrl };
+    const errorField = nonEmptyString(body.error);
+    const message = nonEmptyString(body.message) ??
+        (errorField !== undefined && errorField !== PLAN_LIMIT_REACHED_ERROR
+            ? errorField
+            : undefined);
+    if (message !== undefined)
+        refusal.message = message;
+    const code = nonEmptyString(body.code);
+    if (code !== undefined)
+        refusal.code = code;
+    if (errorField === PLAN_LIMIT_REACHED_ERROR)
+        refusal.error = errorField;
+    const blocked = nonEmptyString(body.blocked);
+    if (blocked !== undefined)
+        refusal.blocked = blocked;
+    const resources = parseResources(body);
+    if (resources !== undefined)
+        refusal.resources = resources;
+    const fixOptions = parseFixOptions(body.fixOptions);
+    if (fixOptions !== undefined)
+        refusal.fixOptions = fixOptions;
+    if (isRecord(body.freeMonth))
+        refusal.freeMonth = { ...body.freeMonth };
+    return refusal;
+}
+/** Parse a raw response text; non-JSON text is never a plan-limit refusal. */
+export function parsePlanLimitRefusalText(text) {
+    try {
+        return parsePlanLimitRefusal(JSON.parse(text));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * One console line for a `plan-limit` sync event: how many files were
+ * refused, the server's sentence, and the upgrade link.
+ */
+export function formatPlanLimitNotice(event) {
+    const files = event.count === undefined
+        ? "New files are"
+        : `${event.count} file${event.count === 1 ? " is" : "s are"}`;
+    const reason = event.message ? ` ${event.message}` : "";
+    return `  ! ${files} paused by your plan limit.${reason} Upgrade: ${event.upgradeUrl}`;
+}
+//# sourceMappingURL=plan-limit.js.map

package/dist/plan-limit.js.map

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

package/dist/plan-limit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=plan-limit.test.d.ts.map

package/dist/plan-limit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-limit.test.d.ts","sourceRoot":"","sources":["../src/plan-limit.test.ts"],"names":[],"mappings":""}

package/dist/plan-limit.test.js

@@ -0,0 +1,132 @@
+import { describe, expect, it } from "vitest";
+import { formatPlanLimitNotice, hasPlanLimitMarker, isHttpsUpgradeUrl, parsePlanLimitRefusal, parsePlanLimitRefusalText, } from "./plan-limit.js";
+import { PLAN_LIMIT_UPGRADE_URL, canonicalPlanLimitBody, companyPresignRefusalRow, legacyMembershipPlanLimitBody, mutationPrepareSkippedBody, personalPresignRefusalRow, } from "./plan-limit.fixtures.js";
+describe("parsePlanLimitRefusal", () => {
+    it("reads every field of the canonical 402 hard-stop body", () => {
+        expect(parsePlanLimitRefusal(canonicalPlanLimitBody())).toEqual({
+            upgradeUrl: PLAN_LIMIT_UPGRADE_URL,
+            message: "New files are paused while Acme is over its Starter limits.",
+            code: "PLAN_LIMIT_EXCEEDED",
+            error: "plan_limit_reached",
+            blocked: "files.create",
+            resources: [
+                { resource: "storageBytes", used: 11_811_160_064, limit: 10_737_418_240 },
+            ],
+            fixOptions: { storageBytes: 10_737_418_240 },
+            freeMonth: {
+                eligible: true,
+                trialDays: 30,
+                url: "https://billing.example.test/companies/acme/billing?offer=free-month",
+            },
+        });
+    });
+    it("recognises the canonical body by its error field even without code or status", () => {
+        const { code: _code, status: _status, ...body } = canonicalPlanLimitBody();
+        expect(parsePlanLimitRefusal(body)).toMatchObject({
+            error: "plan_limit_reached",
+            upgradeUrl: PLAN_LIMIT_UPGRADE_URL,
+        });
+    });
+    it("reads the legacy membership 402 and lifts its top-level resource", () => {
+        expect(parsePlanLimitRefusal(legacyMembershipPlanLimitBody())).toEqual({
+            upgradeUrl: PLAN_LIMIT_UPGRADE_URL,
+            code: "PLAN_LIMIT_EXCEEDED",
+            resources: [{ resource: "users", used: 5, limit: 5 }],
+        });
+    });
+    it("reads a per-item personal presign row and keeps its sentence as the message", () => {
+        expect(parsePlanLimitRefusal(personalPresignRefusalRow("notes/a.md"))).toEqual({
+            upgradeUrl: PLAN_LIMIT_UPGRADE_URL,
+            code: "PLAN_LIMIT_REACHED",
+            message: "notes/a.md was not uploaded: your personal vault is over its plan limit.",
+        });
+    });
+    it("reads the server's exact per-item company presign row", () => {
+        expect(companyPresignRefusalRow("docs/a.md")).toEqual({
+            key: "docs/a.md",
+            op: "put",
+            error: "New files are paused while Acme is over its Starter limits.",
+            code: "PLAN_LIMIT_EXCEEDED",
+            upgradeUrl: PLAN_LIMIT_UPGRADE_URL,
+        });
+        expect(parsePlanLimitRefusal(companyPresignRefusalRow("docs/a.md"))).toEqual({
+            upgradeUrl: PLAN_LIMIT_UPGRADE_URL,
+            code: "PLAN_LIMIT_EXCEEDED",
+            message: "New files are paused while Acme is over its Starter limits.",
+        });
+    });
+    it("reads mutation-prepare's 200 skipped body", () => {
+        expect(parsePlanLimitRefusal(mutationPrepareSkippedBody())).toMatchObject({
+            upgradeUrl: PLAN_LIMIT_UPGRADE_URL,
+            code: "PLAN_LIMIT_REACHED",
+            error: "plan_limit_reached",
+            blocked: "files.create",
+        });
+    });
+    it("does not treat a body with an upgrade link but no plan-limit marker as a refusal", () => {
+        // A billing 402 (no card on file, trial ended) is not a plan limit.
+        expect(parsePlanLimitRefusal({ message: "Upgrade to continue", upgradeUrl: PLAN_LIMIT_UPGRADE_URL })).toBeNull();
+        expect(parsePlanLimitRefusal({ error: "billing_required", upgradeUrl: PLAN_LIMIT_UPGRADE_URL })).toBeNull();
+    });
+    it("accepts only https upgrade links", () => {
+        for (const upgradeUrl of [
+            "http://billing.example.test/companies/acme/billing",
+            "javascript:alert(1)",
+            "file:///etc/passwd",
+            "/companies/acme/billing",
+            "not a url",
+        ]) {
+            expect(parsePlanLimitRefusal({ ...canonicalPlanLimitBody(), upgradeUrl })).toBeNull();
+        }
+        expect(isHttpsUpgradeUrl(PLAN_LIMIT_UPGRADE_URL)).toBe(true);
+        expect(isHttpsUpgradeUrl(undefined)).toBe(false);
+    });
+    it("rejects bodies that are not plan-limit refusals", () => {
+        // No upgrade link: nothing to show the customer.
+        const { upgradeUrl: _u, ...noLink } = canonicalPlanLimitBody();
+        expect(parsePlanLimitRefusal(noLink)).toBeNull();
+        expect(parsePlanLimitRefusal({ message: "Forbidden", upgradeUrl: PLAN_LIMIT_UPGRADE_URL })).toBeNull();
+        // Another per-key denial.
+        expect(parsePlanLimitRefusal({ key: "a", op: "put", error: "denied", code: "FILES_PRESIGN_FORBIDDEN" })).toBeNull();
+        expect(parsePlanLimitRefusal(null)).toBeNull();
+        expect(parsePlanLimitRefusal([canonicalPlanLimitBody()])).toBeNull();
+    });
+    it("drops malformed resources and fix options instead of failing", () => {
+        const body = {
+            ...canonicalPlanLimitBody(),
+            resources: [{ resource: "storageBytes", used: "lots", limit: 1 }, "x"],
+            fixOptions: { storageBytes: "ten" },
+            freeMonth: "yes",
+        };
+        const refusal = parsePlanLimitRefusal(body);
+        expect(refusal).not.toBeNull();
+        expect(refusal).not.toHaveProperty("resources");
+        expect(refusal).not.toHaveProperty("fixOptions");
+        expect(refusal).not.toHaveProperty("freeMonth");
+    });
+    it("parses raw text and ignores non-JSON", () => {
+        expect(parsePlanLimitRefusalText(JSON.stringify(canonicalPlanLimitBody()))?.upgradeUrl).toBe(PLAN_LIMIT_UPGRADE_URL);
+        expect(parsePlanLimitRefusalText("<html>Payment Required</html>")).toBeNull();
+    });
+});
+describe("hasPlanLimitMarker", () => {
+    it("matches the canonical error value and both codes", () => {
+        expect(hasPlanLimitMarker({ error: "plan_limit_reached" })).toBe(true);
+        expect(hasPlanLimitMarker({ code: "PLAN_LIMIT_EXCEEDED" })).toBe(true);
+        expect(hasPlanLimitMarker({ code: "PLAN_LIMIT_REACHED" })).toBe(true);
+        expect(hasPlanLimitMarker({ code: "plan_limit_reached" })).toBe(false);
+        expect(hasPlanLimitMarker({ error: "Plan limit reached" })).toBe(false);
+    });
+});
+describe("formatPlanLimitNotice", () => {
+    it("names the file count, the server sentence and the upgrade link", () => {
+        expect(formatPlanLimitNotice({
+            upgradeUrl: PLAN_LIMIT_UPGRADE_URL,
+            count: 3,
+            message: "New files are paused while Acme is over its Starter limits.",
+        })).toBe(`  ! 3 files are paused by your plan limit. New files are paused while Acme is over its Starter limits. Upgrade: ${PLAN_LIMIT_UPGRADE_URL}`);
+        expect(formatPlanLimitNotice({ upgradeUrl: PLAN_LIMIT_UPGRADE_URL, count: 1 })).toBe(`  ! 1 file is paused by your plan limit. Upgrade: ${PLAN_LIMIT_UPGRADE_URL}`);
+        expect(formatPlanLimitNotice({ upgradeUrl: PLAN_LIMIT_UPGRADE_URL })).toBe(`  ! New files are paused by your plan limit. Upgrade: ${PLAN_LIMIT_UPGRADE_URL}`);
+    });
+});
+//# sourceMappingURL=plan-limit.test.js.map

package/dist/plan-limit.test.js.map

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

package/dist/sync/index.d.ts

@@ -23,7 +23,7 @@ export type { SyncLatencyMetric, PublishSyncLatencyMetricOptions, } from "./metr
 export { createLogger } from "./logger.js";
 export type { CreateLoggerOptions, Logger } from "./logger.js";
 export { MutationClient, mutationRequestDigest } from "./mutation-client.js";
-export type { MutationAuthorization, MutationOperation, MutationRequest, MutationSource, MutationStatus, MutationStatusName, MutationClientOptions, SubmitMutationInput, MutationSubmission, } from "./mutation-client.js";
+export type { MutationAuthorization, MutationOperation, MutationRequest, MutationSource, MutationStatus, MutationStatusName, MutationSkippedStatus, MutationClientOptions, SubmitMutationInput, MutationSubmission, } from "./mutation-client.js";
 export { DefaultParallelSyncCoordinator } from "./parallel-sync-coordinator.js";
 export type { CoordinatorClock, CoordinatorSnapshot, ParallelSyncCoordinator, ParallelSyncCoordinatorOptions, PathIdentity, } from "./parallel-sync-coordinator.js";
 export { InlineSyncWorkerAdapter } from "./sync-work.js";

package/dist/sync/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sync/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sync/index.ts"],"names":[],"mappings":"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"}

package/dist/sync/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sync/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,oBAAoB,EACpB,wBAAwB,EACxB,eAAe,EACf,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,uBAAuB,EACvB,2BAA2B,GAC5B,MAAM,iBAAiB,CAAC;AAQzB,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAQ3E,OAAO,EACL,gCAAgC,EAChC,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,oBAAoB,EACpB,4BAA4B,EAC5B,oBAAoB,EACpB,4BAA4B,EAC5B,kBAAkB,EAClB,yBAAyB,EACzB,mCAAmC,EACnC,iCAAiC,EACjC,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,wBAAwB,EAAE,iCAAiC,EAAE,qBAAqB,EAAE,qCAAqC,EAAE,MAAM,yBAAyB,CAAC;AAGpK,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAIvE,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,kBAAkB,EAClB,iCAAiC,EACjC,yBAAyB,EACzB,oBAAoB,EACpB,gCAAgC,EAChC,mCAAmC,GACpC,MAAM,oBAAoB,CAAC;AAgB5B,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,cAAc,CAAC;AAMtB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAa7E,OAAO,EAAE,8BAA8B,EAAE,MAAM,gCAAgC,CAAC;AAShF,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAiBzD,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAY3I,OAAO,EAAE,6BAA6B,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAC;AAE5G,OAAO,EAAE,4BAA4B,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sync/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,oBAAoB,EACpB,wBAAwB,EACxB,eAAe,EACf,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,uBAAuB,EACvB,2BAA2B,GAC5B,MAAM,iBAAiB,CAAC;AAQzB,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAQ3E,OAAO,EACL,gCAAgC,EAChC,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,oBAAoB,EACpB,4BAA4B,EAC5B,oBAAoB,EACpB,4BAA4B,EAC5B,kBAAkB,EAClB,yBAAyB,EACzB,mCAAmC,EACnC,iCAAiC,EACjC,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,wBAAwB,EAAE,iCAAiC,EAAE,qBAAqB,EAAE,qCAAqC,EAAE,MAAM,yBAAyB,CAAC;AAGpK,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAIvE,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,kBAAkB,EAClB,iCAAiC,EACjC,yBAAyB,EACzB,oBAAoB,EACpB,gCAAgC,EAChC,mCAAmC,GACpC,MAAM,oBAAoB,CAAC;AAgB5B,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,cAAc,CAAC;AAMtB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAc7E,OAAO,EAAE,8BAA8B,EAAE,MAAM,gCAAgC,CAAC;AAShF,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAiBzD,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAY3I,OAAO,EAAE,6BAA6B,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAC;AAE5G,OAAO,EAAE,4BAA4B,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/sync/mutation-client.d.ts

@@ -1,7 +1,8 @@
 import { CandidateUploader, type CandidateFetch, type CandidateTransportAuthorization } from "./candidate-uploader.js";
 import { DurableAttemptSpool, MultipartUploader } from "./multipart-uploader.js";
+import { type PlanLimitRefusal } from "../plan-limit.js";
 export type MutationOperation = "upsert" | "delete";
-export type MutationStatusName = "prepared" | "uploading" | "candidate-ready" | "ready" | "applying" | "committed" | "conflict" | "rejected" | "blocked";
+export type MutationStatusName = "prepared" | "uploading" | "candidate-ready" | "ready" | "applying" | "committed" | "conflict" | "rejected" | "blocked" | "skipped";
 export interface MutationSource {
     kind: "regular" | "symlink";
     mode: number;
@@ -21,6 +22,17 @@ export interface MutationRequest {
     scopeRevision: string;
     source?: MutationSource;
 }
+/**
+ * The server refused the mutation because of the plan limit, before any
+ * attempt was created. Both the hard-stop 402 body and mutation-prepare's
+ * `200 {skipped: true, …}` arrive as this status. It is terminal for the
+ * submission and carries no attemptId; the change can be submitted again
+ * later.
+ */
+export type MutationSkippedStatus = {
+    status: "skipped";
+    reason: "plan-limit";
+} & PlanLimitRefusal;
 export type MutationStatus = {
     status: "prepared" | "uploading" | "candidate-ready" | "ready" | "applying";
     attemptId: string;
@@ -37,7 +49,7 @@ export type MutationStatus = {
     status: "rejected" | "blocked";
     attemptId: string;
     code: string;
-};
+} | MutationSkippedStatus;
 export type MutationAuthorization = CandidateTransportAuthorization;
 export interface MutationClientOptions {
     apiUrl: string;

package/dist/sync/mutation-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mutation-client.d.ts","sourceRoot":"","sources":["../../src/sync/mutation-client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mutation-client.d.ts","sourceRoot":"","sources":["../../src/sync/mutation-client.ts"],"names":[],"mappings":"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"}

package/dist/sync/mutation-client.js

@@ -11,6 +11,7 @@ import { createHash } from "node:crypto";
 import * as fs from "node:fs";
 import { CandidateUploader, MAX_SMALL_CANDIDATE_BYTES, } from "./candidate-uploader.js";
 import { DurableAttemptSpool, MultipartUploader } from "./multipart-uploader.js";
+import { parsePlanLimitRefusal } from "../plan-limit.js";
 const SHA256 = /^sha256:[a-f0-9]{64}$/;
 const OPAQUE_ID = /^[A-Za-z0-9._~-]{1,512}$/;
 function isRecord(value) {
@@ -69,7 +70,22 @@ function validateRequest(request) {
         throw new Error("realtime mutation: upsert source metadata is invalid");
     }
 }
+/**
+ * A plan-limit refusal in any of the server's forms (402 hard-stop body, or
+ * mutation-prepare's `200 {skipped: true}`), as a skipped status. Null when
+ * the body is not one.
+ */
+function planLimitSkip(value) {
+    const refusal = parsePlanLimitRefusal(value);
+    return refusal ? { status: "skipped", reason: "plan-limit", ...refusal } : null;
+}
 function parseStatus(value) {
+    if (isRecord(value) && value.skipped === true) {
+        const skipped = planLimitSkip(value);
+        if (!skipped)
+            throw new Error("realtime mutation: skipped response is invalid");
+        return skipped;
+    }
     if (!isRecord(value) || typeof value.status !== "string" || typeof value.attemptId !== "string" || !OPAQUE_ID.test(value.attemptId)) {
         throw new Error("realtime mutation: status response is invalid");
     }
@@ -100,7 +116,7 @@ function parseStatus(value) {
     }
 }
 function isTerminal(status) {
-    return status.status === "committed" || status.status === "conflict" || status.status === "rejected" || status.status === "blocked";
+    return status.status === "committed" || status.status === "conflict" || status.status === "rejected" || status.status === "blocked" || status.status === "skipped";
 }
 export class MutationClient {
     apiUrl;
@@ -136,6 +152,9 @@ export class MutationClient {
             }
         }
         const status = await this.prepare(input.authorization, input.request);
+        // A plan-limit skip created no attempt: nothing to record or commit.
+        if (status.status === "skipped")
+            return { requestDigest: digest, status };
         if (!isTerminal(status))
             await input.onPrepared?.(status.attemptId);
         if (isTerminal(status) || input.request.operation === "delete") {
@@ -220,8 +239,21 @@ export class MutationClient {
         const text = await response.text().catch((error) => {
             throw new Error(`realtime mutation: ${label} response unreadable; recover with status: ${error instanceof Error ? error.message : String(error)}`);
         });
-        if (!response.ok)
+        if (!response.ok) {
+            // A plan-limit refusal is an answer, not a failure: report it as a
+            // skipped status instead of an error the caller would retry.
+            let body;
+            try {
+                body = JSON.parse(text);
+            }
+            catch {
+                body = undefined;
+            }
+            const skipped = planLimitSkip(body);
+            if (skipped)
+                return skipped;
             throw new Error(`realtime mutation: ${label} failed (${response.status}); recover with status: ${text.slice(0, 300)}`);
+        }
         try {
             return parseStatus(JSON.parse(text));
         }