@fias/plugin-dev-harness 1.11.0 → 1.12.0

package/dist/cli/assets/api.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Thin HTTP client for the asset library routes.
+ *
+ * All routes live under `/v1/contributor/arches/:archeId/...` and
+ * accept either a session cookie or `Bearer fias_sk_*`. The CLI
+ * always uses the bearer key so we don't need cookie / CSRF
+ * handling.
+ *
+ * Errors surface as `AssetApiError` with the route response body
+ * (or a synthetic `{code, message}` for transport failures), so
+ * each command can map status / code to its CLI exit-code policy
+ * without re-parsing JSON.
+ */
+export declare class AssetApiError extends Error {
+    readonly status: number;
+    readonly code: string;
+    readonly details?: unknown | undefined;
+    constructor(status: number, code: string, message: string, details?: unknown | undefined);
+}
+export interface AssetApiClient {
+    /** Convenience: GET as JSON. */
+    getJson<T = unknown>(path: string): Promise<T>;
+    /** Convenience: POST as JSON. */
+    postJson<T = unknown>(path: string, body?: unknown): Promise<T>;
+    /** PATCH JSON. */
+    patchJson<T = unknown>(path: string, body?: unknown): Promise<T>;
+    /** PUT raw bytes (for the S3 step of the upload flow). */
+    putBytes(url: string, contentType: string, bytes: Buffer): Promise<void>;
+    /** Returns the configured base URL — useful for log messages. */
+    baseUrl(): string;
+}
+export declare function createAssetApiClient(input: {
+    apiUrl: string;
+    apiKey: string;
+}): AssetApiClient;
+export interface FiasPluginManifest {
+    name: string;
+    version: string;
+    permissions?: string[];
+}
+/**
+ * Reads `fias-plugin.json` from the cwd. Throws a friendly error
+ * message if absent or malformed — the CLI catches these and exits
+ * with the validation exit code.
+ */
+export declare function readPluginManifest(cwd?: string): FiasPluginManifest;
+export declare const EXIT_GENERAL = 1;
+export declare const EXIT_AUTH = 2;
+export declare const EXIT_QUOTA_OR_BILLING = 3;
+export declare const EXIT_VALIDATION = 4;
+export declare const EXIT_NOT_FOUND = 5;
+export declare function exitCodeForApiError(err: AssetApiError): number;
+//# sourceMappingURL=api.d.ts.map

package/dist/cli/assets/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/cli/assets/api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,qBAAa,aAAc,SAAQ,KAAK;aAEpB,MAAM,EAAE,MAAM;aACd,IAAI,EAAE,MAAM;aAEZ,OAAO,CAAC,EAAE,OAAO;gBAHjB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM,EACC,OAAO,CAAC,EAAE,OAAO,YAAA;CAKpC;AAED,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC/C,iCAAiC;IACjC,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAChE,kBAAkB;IAClB,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACjE,0DAA0D;IAC1D,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzE,iEAAiE;IACjE,OAAO,IAAI,MAAM,CAAC;CACnB;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,cAAc,CA6D9F;AAMD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,GAAE,MAAsB,GAAG,kBAAkB,CA2BlF;AAGD,eAAO,MAAM,YAAY,IAAI,CAAC;AAC9B,eAAO,MAAM,SAAS,IAAI,CAAC;AAC3B,eAAO,MAAM,qBAAqB,IAAI,CAAC;AACvC,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAM9D"}

package/dist/cli/assets/api.js

@@ -0,0 +1,165 @@
+"use strict";
+/**
+ * Thin HTTP client for the asset library routes.
+ *
+ * All routes live under `/v1/contributor/arches/:archeId/...` and
+ * accept either a session cookie or `Bearer fias_sk_*`. The CLI
+ * always uses the bearer key so we don't need cookie / CSRF
+ * handling.
+ *
+ * Errors surface as `AssetApiError` with the route response body
+ * (or a synthetic `{code, message}` for transport failures), so
+ * each command can map status / code to its CLI exit-code policy
+ * without re-parsing JSON.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EXIT_NOT_FOUND = exports.EXIT_VALIDATION = exports.EXIT_QUOTA_OR_BILLING = exports.EXIT_AUTH = exports.EXIT_GENERAL = exports.AssetApiError = void 0;
+exports.createAssetApiClient = createAssetApiClient;
+exports.readPluginManifest = readPluginManifest;
+exports.exitCodeForApiError = exitCodeForApiError;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+class AssetApiError extends Error {
+    constructor(status, code, message, details) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.details = details;
+        this.name = 'AssetApiError';
+    }
+}
+exports.AssetApiError = AssetApiError;
+function createAssetApiClient(input) {
+    async function call(method, relPath, body) {
+        const res = await fetch(`${input.apiUrl}${relPath}`, {
+            method,
+            headers: {
+                Authorization: `Bearer ${input.apiKey}`,
+                'Content-Type': 'application/json',
+            },
+            body: body !== undefined ? JSON.stringify(body) : undefined,
+        });
+        const text = await res.text();
+        let parsed = undefined;
+        try {
+            parsed = text ? JSON.parse(text) : undefined;
+        }
+        catch {
+            parsed = text;
+        }
+        if (!res.ok) {
+            const errBody = parsed
+                ?.error;
+            throw new AssetApiError(res.status, errBody?.code ?? `HTTP_${res.status}`, errBody?.message ?? text ?? `HTTP ${res.status}`, errBody?.details);
+        }
+        return parsed;
+    }
+    return {
+        getJson: (p) => call('GET', p),
+        postJson: (p, b) => call('POST', p, b),
+        patchJson: (p, b) => call('PATCH', p, b),
+        async putBytes(url, contentType, bytes) {
+            // Direct S3 PUT — no Authorization header (the URL is presigned).
+            // The runtime fetch accepts a Node Buffer as a body, but the
+            // `node` lib's BodyInit type doesn't include it; cast through
+            // Uint8Array (which IS a BodyInit) without copying.
+            const res = await fetch(url, {
+                method: 'PUT',
+                headers: {
+                    'Content-Type': contentType,
+                    'Content-Length': String(bytes.byteLength),
+                },
+                // Node's runtime fetch accepts a Buffer; the @types/node and
+                // root-tsconfig versions differ on whether Buffer is in
+                // BodyInit, so cast through unknown to satisfy both.
+                body: bytes,
+            });
+            if (!res.ok) {
+                const text = await res.text();
+                throw new AssetApiError(res.status, `S3_PUT_${res.status}`, text || `HTTP ${res.status}`);
+            }
+        },
+        baseUrl: () => input.apiUrl,
+    };
+}
+/**
+ * Reads `fias-plugin.json` from the cwd. Throws a friendly error
+ * message if absent or malformed — the CLI catches these and exits
+ * with the validation exit code.
+ */
+function readPluginManifest(cwd = process.cwd()) {
+    const manifestPath = path.resolve(cwd, 'fias-plugin.json');
+    if (!fs.existsSync(manifestPath)) {
+        throw new Error(`fias-plugin.json not found in ${cwd}. Run from the root of your plugin project.`);
+    }
+    let raw;
+    try {
+        raw = JSON.parse(fs.readFileSync(manifestPath, 'utf-8'));
+    }
+    catch (err) {
+        throw new Error(`Failed to parse fias-plugin.json: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    const m = raw;
+    if (typeof m.name !== 'string' || m.name.length === 0) {
+        throw new Error('fias-plugin.json: `name` is missing or invalid');
+    }
+    if (typeof m.version !== 'string' || m.version.length === 0) {
+        throw new Error('fias-plugin.json: `version` is missing or invalid');
+    }
+    return {
+        name: m.name,
+        version: m.version,
+        permissions: Array.isArray(m.permissions) ? m.permissions : undefined,
+    };
+}
+// Stable CLI exit codes — referenced by individual command files.
+exports.EXIT_GENERAL = 1;
+exports.EXIT_AUTH = 2;
+exports.EXIT_QUOTA_OR_BILLING = 3;
+exports.EXIT_VALIDATION = 4;
+exports.EXIT_NOT_FOUND = 5;
+function exitCodeForApiError(err) {
+    if (err.status === 401 || err.status === 403)
+        return exports.EXIT_AUTH;
+    if (err.status === 404)
+        return exports.EXIT_NOT_FOUND;
+    if (err.status === 413 || err.status === 402)
+        return exports.EXIT_QUOTA_OR_BILLING;
+    if (err.status >= 400 && err.status < 500)
+        return exports.EXIT_VALIDATION;
+    return exports.EXIT_GENERAL;
+}
+//# sourceMappingURL=api.js.map

package/dist/cli/assets/api.js.map

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

package/dist/cli/assets/api.test.d.ts

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

package/dist/cli/assets/api.test.d.ts.map

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

package/dist/cli/assets/api.test.js

@@ -0,0 +1,77 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const api_1 = require("./api");
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+describe('exitCodeForApiError', () => {
+    it('maps 401/403 → EXIT_AUTH', () => {
+        expect((0, api_1.exitCodeForApiError)(new api_1.AssetApiError(401, 'X', 'm'))).toBe(api_1.EXIT_AUTH);
+        expect((0, api_1.exitCodeForApiError)(new api_1.AssetApiError(403, 'X', 'm'))).toBe(api_1.EXIT_AUTH);
+    });
+    it('maps 404 → EXIT_NOT_FOUND', () => {
+        expect((0, api_1.exitCodeForApiError)(new api_1.AssetApiError(404, 'X', 'm'))).toBe(api_1.EXIT_NOT_FOUND);
+    });
+    it('maps 413 (quota) → EXIT_QUOTA_OR_BILLING', () => {
+        expect((0, api_1.exitCodeForApiError)(new api_1.AssetApiError(413, 'STORAGE_QUOTA_EXCEEDED', 'm'))).toBe(api_1.EXIT_QUOTA_OR_BILLING);
+    });
+    it('maps 4xx → EXIT_VALIDATION', () => {
+        expect((0, api_1.exitCodeForApiError)(new api_1.AssetApiError(422, 'BAD_BYTES', 'm'))).toBe(api_1.EXIT_VALIDATION);
+    });
+});
+describe('readPluginManifest', () => {
+    let tmp;
+    beforeEach(() => {
+        tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'fias-cli-manifest-'));
+    });
+    afterEach(() => {
+        fs.rmSync(tmp, { recursive: true, force: true });
+    });
+    it('reads name + version from fias-plugin.json', () => {
+        fs.writeFileSync(path.join(tmp, 'fias-plugin.json'), JSON.stringify({ name: "Blackfish Children's Books", version: '1.2.4' }));
+        const m = (0, api_1.readPluginManifest)(tmp);
+        expect(m.name).toBe("Blackfish Children's Books");
+        expect(m.version).toBe('1.2.4');
+    });
+    it('throws a friendly error when manifest is absent', () => {
+        expect(() => (0, api_1.readPluginManifest)(tmp)).toThrow(/fias-plugin.json not found/);
+    });
+    it('throws when name is missing', () => {
+        fs.writeFileSync(path.join(tmp, 'fias-plugin.json'), JSON.stringify({ version: '1.0.0' }));
+        expect(() => (0, api_1.readPluginManifest)(tmp)).toThrow(/`name` is missing/);
+    });
+});
+//# sourceMappingURL=api.test.js.map

package/dist/cli/assets/api.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.test.js","sourceRoot":"","sources":["../../../src/cli/assets/api.test.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,+BAQe;AACf,uCAAyB;AACzB,uCAAyB;AACzB,2CAA6B;AAE7B,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,MAAM,CAAC,IAAA,yBAAmB,EAAC,IAAI,mBAAa,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,eAAS,CAAC,CAAC;QAC9E,MAAM,CAAC,IAAA,yBAAmB,EAAC,IAAI,mBAAa,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,eAAS,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,CAAC,IAAA,yBAAmB,EAAC,IAAI,mBAAa,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,oBAAc,CAAC,CAAC;IACrF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,CAAC,IAAA,yBAAmB,EAAC,IAAI,mBAAa,CAAC,GAAG,EAAE,wBAAwB,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CACrF,2BAAqB,CACtB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,CAAC,IAAA,yBAAmB,EAAC,IAAI,mBAAa,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,qBAAe,CAAC,CAAC;IAC9F,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,IAAI,GAAW,CAAC;IAChB,UAAU,CAAC,GAAG,EAAE;QACd,GAAG,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,oBAAoB,CAAC,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IACH,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,EAAE,CAAC,aAAa,CACd,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,kBAAkB,CAAC,EAClC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,4BAA4B,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CACzE,CAAC;QACF,MAAM,CAAC,GAAG,IAAA,wBAAkB,EAAC,GAAG,CAAC,CAAC;QAClC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QAClD,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,wBAAkB,EAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,4BAA4B,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,kBAAkB,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;QAC3F,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,wBAAkB,EAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/cli/assets/arche-resolver.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Resolves the contributor's arche ID for the current plugin
+ * directory. External contributors don't memorize arche_… ids;
+ * the CLI looks up by plugin name from `fias-plugin.json`.
+ *
+ * Resolution order:
+ *   1. Explicit `--arche-id` flag → return as-is. Required for CI.
+ *   2. Cache hit at `.fias/<env>/arche.json` (matched on plugin
+ *      name) → return cached id without a network call.
+ *   3. `GET /v1/contributor/arches?limit=100`, find by exact
+ *      `name` match. If multiple, prefer the most recent (status
+ *      = published > draft, then highest version).
+ *   4. None found → throw a clear error directing the contributor
+ *      to `fias-dev submit` (which creates the arche server-side).
+ */
+import { type Environment } from '../../config/credentials';
+import { type AssetApiClient } from './api';
+export declare function resolveArcheId(input: {
+    cwd: string;
+    env: Environment;
+    client: AssetApiClient;
+    explicit?: string | null;
+}): Promise<string>;
+//# sourceMappingURL=arche-resolver.d.ts.map

package/dist/cli/assets/arche-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arche-resolver.d.ts","sourceRoot":"","sources":["../../../src/cli/assets/arche-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,OAAO,CAAC;AAqChE,wBAAsB,cAAc,CAAC,KAAK,EAAE;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,WAAW,CAAC;IACjB,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,GAAG,OAAO,CAAC,MAAM,CAAC,CA8ClB"}

package/dist/cli/assets/arche-resolver.js

@@ -0,0 +1,114 @@
+"use strict";
+/**
+ * Resolves the contributor's arche ID for the current plugin
+ * directory. External contributors don't memorize arche_… ids;
+ * the CLI looks up by plugin name from `fias-plugin.json`.
+ *
+ * Resolution order:
+ *   1. Explicit `--arche-id` flag → return as-is. Required for CI.
+ *   2. Cache hit at `.fias/<env>/arche.json` (matched on plugin
+ *      name) → return cached id without a network call.
+ *   3. `GET /v1/contributor/arches?limit=100`, find by exact
+ *      `name` match. If multiple, prefer the most recent (status
+ *      = published > draft, then highest version).
+ *   4. None found → throw a clear error directing the contributor
+ *      to `fias-dev submit` (which creates the arche server-side).
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveArcheId = resolveArcheId;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const api_1 = require("./api");
+const CACHE_DIRNAME = '.fias';
+function cacheFile(cwd, env) {
+    return path.join(cwd, CACHE_DIRNAME, env, 'arche.json');
+}
+function readCache(cwd, env) {
+    const file = cacheFile(cwd, env);
+    if (!fs.existsSync(file))
+        return null;
+    try {
+        return JSON.parse(fs.readFileSync(file, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+function writeCache(cwd, env, rec) {
+    const file = cacheFile(cwd, env);
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    fs.writeFileSync(file, JSON.stringify(rec, null, 2));
+}
+async function resolveArcheId(input) {
+    if (input.explicit)
+        return input.explicit;
+    const manifest = (0, api_1.readPluginManifest)(input.cwd);
+    const cached = readCache(input.cwd, input.env);
+    if (cached && cached.pluginName === manifest.name)
+        return cached.archeId;
+    // Lookup via API. The contributor portal route returns an envelope
+    // with a `result` array (matches existing list-arches shape).
+    const response = await input.client.getJson('/contributor/arches?limit=100');
+    const list = response.result?.items ?? response.items ?? [];
+    const matches = list.filter((r) => r.name === manifest.name);
+    if (matches.length === 0) {
+        throw new Error([
+            `No arche named "${manifest.name}" found for the current contributor.`,
+            '',
+            'If this is a brand-new plugin, run `fias-dev submit` first to create',
+            'the arche row server-side. If your plugin has a different display name',
+            'in the marketplace, pass --arche-id <arche_id> explicitly.',
+        ].join('\n'));
+    }
+    // Prefer published over draft, then most recent version. Falling
+    // back to the first match if status / version are absent keeps the
+    // resolver robust against partial responses.
+    const ranked = [...matches].sort((a, b) => {
+        const aPub = a.status === 'published' ? 1 : 0;
+        const bPub = b.status === 'published' ? 1 : 0;
+        if (aPub !== bPub)
+            return bPub - aPub;
+        return (b.version ?? '').localeCompare(a.version ?? '');
+    });
+    const chosen = ranked[0];
+    writeCache(input.cwd, input.env, {
+        pluginName: manifest.name,
+        archeId: chosen.archId,
+        resolvedAt: new Date().toISOString(),
+    });
+    return chosen.archId;
+}
+//# sourceMappingURL=arche-resolver.js.map

package/dist/cli/assets/arche-resolver.js.map

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

package/dist/cli/assets/arche-resolver.test.d.ts

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

package/dist/cli/assets/arche-resolver.test.d.ts.map

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

package/dist/cli/assets/arche-resolver.test.js

@@ -0,0 +1,108 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const arche_resolver_1 = require("./arche-resolver");
+function mockClient(items) {
+    const calls = [];
+    const client = {
+        async getJson(p) {
+            calls.push({ method: 'GET', path: p });
+            return { result: { items } };
+        },
+        async postJson() {
+            throw new Error('not used');
+        },
+        async patchJson() {
+            throw new Error('not used');
+        },
+        async putBytes() {
+            throw new Error('not used');
+        },
+        baseUrl: () => 'https://api.staging.fias.io/v1',
+    };
+    return Object.assign(client, { __calls: calls });
+}
+describe('resolveArcheId', () => {
+    let tmp;
+    beforeEach(() => {
+        tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'fias-cli-resolver-'));
+    });
+    afterEach(() => {
+        fs.rmSync(tmp, { recursive: true, force: true });
+    });
+    it('returns the explicit --arche-id flag when provided (no API call)', async () => {
+        fs.writeFileSync(path.join(tmp, 'fias-plugin.json'), JSON.stringify({ name: 'Blackfish', version: '1.0.0' }));
+        const client = mockClient([]);
+        const id = await (0, arche_resolver_1.resolveArcheId)({
+            cwd: tmp,
+            env: 'staging',
+            client,
+            explicit: 'arc_explicit_override_0123456789abcdef',
+        });
+        expect(id).toBe('arc_explicit_override_0123456789abcdef');
+        expect(client.__calls).toHaveLength(0);
+    });
+    it('caches the resolved arche ID and returns it on the next call without an API hit', async () => {
+        fs.writeFileSync(path.join(tmp, 'fias-plugin.json'), JSON.stringify({ name: 'Blackfish', version: '1.0.0' }));
+        const client = mockClient([
+            { archId: 'arc_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4', name: 'Blackfish' },
+        ]);
+        const id1 = await (0, arche_resolver_1.resolveArcheId)({ cwd: tmp, env: 'staging', client });
+        expect(id1).toBe('arc_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4');
+        expect(client.__calls).toHaveLength(1);
+        const id2 = await (0, arche_resolver_1.resolveArcheId)({ cwd: tmp, env: 'staging', client });
+        expect(id2).toBe('arc_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4');
+        // Cache hit — no second API call.
+        expect(client.__calls).toHaveLength(1);
+    });
+    it('prefers published over draft when multiple matches exist', async () => {
+        fs.writeFileSync(path.join(tmp, 'fias-plugin.json'), JSON.stringify({ name: 'Blackfish', version: '1.0.0' }));
+        const client = mockClient([
+            { archId: 'arc_draft00000000000000000000000000', name: 'Blackfish', status: 'draft' },
+            { archId: 'arc_pub0000000000000000000000000000', name: 'Blackfish', status: 'published' },
+        ]);
+        const id = await (0, arche_resolver_1.resolveArcheId)({ cwd: tmp, env: 'staging', client });
+        expect(id).toBe('arc_pub0000000000000000000000000000');
+    });
+    it('throws a clear error when no match exists', async () => {
+        fs.writeFileSync(path.join(tmp, 'fias-plugin.json'), JSON.stringify({ name: 'NoSuchPlugin', version: '1.0.0' }));
+        const client = mockClient([{ archId: 'arc_x', name: 'OtherPlugin' }]);
+        await expect((0, arche_resolver_1.resolveArcheId)({ cwd: tmp, env: 'staging', client })).rejects.toThrow(/No arche named "NoSuchPlugin"/);
+    });
+});
+//# sourceMappingURL=arche-resolver.test.js.map

package/dist/cli/assets/arche-resolver.test.js.map

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

package/dist/cli/assets/commands.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Smoke tests for the asset CLI commands. The full happy paths
+ * involve `fetch` against a live API and presigned S3 PUT — those
+ * land in the staging smoke test. These unit tests exercise the
+ * common branches (auth missing, env validation, registration).
+ */
+export {};
+//# sourceMappingURL=commands.test.d.ts.map

package/dist/cli/assets/commands.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.test.d.ts","sourceRoot":"","sources":["../../../src/cli/assets/commands.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}