gooseworks 0.2.4 → 0.2.6

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEU,QAAA,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,2BAA2B,CAAC;AAC1E,QAAA,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,2BAA2B,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEU,QAAA,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,2BAA2B,CAAC;AAC1E,QAAA,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,2BAA2B,CAAC;AAC/F,mFAAmF;AACnF,8FAA8F;AACjF,QAAA,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,8BAA8B,CAAC"}

package/dist/index.js

@@ -8,6 +8,8 @@ const logout_1 = require("./commands/logout");
 const update_1 = require("./commands/update");
 const credits_1 = require("./commands/credits");
 const search_1 = require("./commands/search");
+const styles_1 = require("./commands/styles");
+const formats_1 = require("./commands/formats");
 const version_1 = require("./version");
 const program = new commander_1.Command();
 program
@@ -20,5 +22,7 @@ program.addCommand(logout_1.logoutCommand);
 program.addCommand(update_1.updateCommand);
 program.addCommand(credits_1.creditsCommand);
 program.addCommand(search_1.searchCommand);
+program.addCommand(styles_1.stylesCommand);
+program.addCommand(formats_1.formatsCommand);
 program.parse();
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AACA,yCAAoC;AACpC,gDAAoD;AACpD,4CAAgD;AAChD,8CAAkD;AAClD,8CAAkD;AAClD,gDAAoD;AACpD,8CAAkD;AAClD,uCAAuC;AAEvC,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAC9B,OAAO;KACJ,IAAI,CAAC,YAAY,CAAC;KAClB,WAAW,CAAC,yDAAyD,CAAC;KACtE,OAAO,CAAC,IAAA,oBAAU,GAAE,CAAC,CAAC;AAEzB,OAAO,CAAC,UAAU,CAAC,wBAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,oBAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,sBAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,sBAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,wBAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,sBAAa,CAAC,CAAC;AAElC,OAAO,CAAC,KAAK,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AACA,yCAAoC;AACpC,gDAAoD;AACpD,4CAAgD;AAChD,8CAAkD;AAClD,8CAAkD;AAClD,gDAAoD;AACpD,8CAAkD;AAClD,8CAAkD;AAClD,gDAAoD;AACpD,uCAAuC;AAEvC,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAC9B,OAAO;KACJ,IAAI,CAAC,YAAY,CAAC;KAClB,WAAW,CAAC,yDAAyD,CAAC;KACtE,OAAO,CAAC,IAAA,oBAAU,GAAE,CAAC,CAAC;AAEzB,OAAO,CAAC,UAAU,CAAC,wBAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,oBAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,sBAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,sBAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,wBAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,sBAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,sBAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,wBAAc,CAAC,CAAC;AAEnC,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/lib/graphics-api.d.ts

@@ -0,0 +1,106 @@
+/**
+ * HTTP client for the Gooseworks graphics API.
+ *
+ * Uses the global fetch (Node 18+) and FormData/Blob for multipart uploads.
+ * Endpoint shapes are documented in gooseworks-app GOOSE-1468.
+ */
+import type { ResolvedExampleFile } from './graphics-manifest';
+export interface ApiClientOptions {
+    apiBase: string;
+    /** Bearer token. Optional for public reads, but always sent if available. */
+    apiKey?: string | null;
+}
+export interface AuthedApiClientOptions {
+    apiBase: string;
+    apiKey: string;
+}
+export declare class ApiError extends Error {
+    readonly status: number;
+    readonly code: string | null;
+    readonly body?: unknown | undefined;
+    constructor(status: number, code: string | null, message: string, body?: unknown | undefined);
+}
+export declare class NetworkError extends Error {
+    readonly cause?: unknown | undefined;
+    constructor(message: string, cause?: unknown | undefined);
+}
+export interface ListQuery {
+    q?: string;
+    mood?: string;
+    tag?: string;
+    featured?: boolean;
+    limit?: number;
+    offset?: number;
+}
+export interface GraphicStyleSummary {
+    id: string;
+    slug: string;
+    name: string;
+    description?: string | null;
+    moodGroup?: string | null;
+    tags?: string[];
+    featured?: boolean;
+    authorHandle?: string | null;
+    [key: string]: unknown;
+}
+export interface GraphicFormatSummary {
+    id: string;
+    slug: string;
+    name: string;
+    description?: string | null;
+    width?: number;
+    height?: number;
+    featured?: boolean;
+    authorHandle?: string | null;
+    [key: string]: unknown;
+}
+export interface ListEnvelope<T> {
+    status: 'success';
+    data: T[];
+    meta?: {
+        total?: number;
+        limit?: number;
+        offset?: number;
+    };
+}
+export declare function listStyles(opts: ApiClientOptions, query?: ListQuery): Promise<ListEnvelope<GraphicStyleSummary>>;
+export declare function listFormats(opts: ApiClientOptions, query?: ListQuery): Promise<ListEnvelope<GraphicFormatSummary>>;
+export interface ItemEnvelope<T> {
+    status: 'success';
+    data: T;
+}
+/**
+ * ETag-aware response for JSON record fetches. On 304, `envelope` is null
+ * and the caller should fall back to its cached body.
+ */
+export interface RecordResponse<T> {
+    status: 200 | 304;
+    envelope: ItemEnvelope<T> | null;
+    etag: string | null;
+}
+export declare function getStyleRecord(opts: ApiClientOptions, slug: string, etag?: string | null): Promise<RecordResponse<GraphicStyleSummary & {
+    examples?: unknown[];
+}>>;
+export declare function getFormatRecord(opts: ApiClientOptions, slug: string, etag?: string | null): Promise<RecordResponse<GraphicFormatSummary & {
+    examples?: unknown[];
+}>>;
+export interface MarkdownResponse {
+    /** 200 with a fresh body, or 304 if If-None-Match matched (body is null). */
+    status: 200 | 304;
+    body: string | null;
+    etag: string | null;
+}
+export declare function getStyleDesignMd(opts: ApiClientOptions, slug: string, etag?: string | null): Promise<MarkdownResponse>;
+export declare function getFormatSpecMd(opts: ApiClientOptions, slug: string, etag?: string | null): Promise<MarkdownResponse>;
+export interface WriteResult {
+    slug: string;
+    id: string;
+}
+export declare function publishStyle(opts: AuthedApiClientOptions, manifest: unknown, files: ResolvedExampleFile[]): Promise<WriteResult>;
+export declare function updateStyle(opts: AuthedApiClientOptions, slug: string, manifest: unknown, files: ResolvedExampleFile[]): Promise<WriteResult>;
+export declare function deleteStyle(opts: AuthedApiClientOptions, slug: string): Promise<void>;
+export declare function publishFormat(opts: AuthedApiClientOptions, manifest: unknown, files: ResolvedExampleFile[]): Promise<WriteResult>;
+export declare function updateFormat(opts: AuthedApiClientOptions, slug: string, manifest: unknown, files: ResolvedExampleFile[]): Promise<WriteResult>;
+export declare function deleteFormat(opts: AuthedApiClientOptions, slug: string): Promise<void>;
+export declare function downloadBytes(url: string): Promise<Buffer>;
+//# sourceMappingURL=graphics-api.d.ts.map

package/dist/lib/graphics-api.d.ts.map

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

package/dist/lib/graphics-api.js

@@ -0,0 +1,310 @@
+"use strict";
+/**
+ * HTTP client for the Gooseworks graphics API.
+ *
+ * Uses the global fetch (Node 18+) and FormData/Blob for multipart uploads.
+ * Endpoint shapes are documented in gooseworks-app GOOSE-1468.
+ */
+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.NetworkError = exports.ApiError = void 0;
+exports.listStyles = listStyles;
+exports.listFormats = listFormats;
+exports.getStyleRecord = getStyleRecord;
+exports.getFormatRecord = getFormatRecord;
+exports.getStyleDesignMd = getStyleDesignMd;
+exports.getFormatSpecMd = getFormatSpecMd;
+exports.publishStyle = publishStyle;
+exports.updateStyle = updateStyle;
+exports.deleteStyle = deleteStyle;
+exports.publishFormat = publishFormat;
+exports.updateFormat = updateFormat;
+exports.deleteFormat = deleteFormat;
+exports.downloadBytes = downloadBytes;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+class ApiError extends Error {
+    status;
+    code;
+    body;
+    constructor(status, code, message, body) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.body = body;
+        this.name = 'ApiError';
+    }
+}
+exports.ApiError = ApiError;
+class NetworkError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = 'NetworkError';
+    }
+}
+exports.NetworkError = NetworkError;
+function authHeaders(apiKey) {
+    return apiKey ? { Authorization: `Bearer ${apiKey}` } : {};
+}
+async function readJsonSafe(res) {
+    const text = await res.text();
+    if (!text)
+        return null;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+function extractMessage(body, fallback) {
+    if (body && typeof body === 'object') {
+        const env = body;
+        if (typeof env.message === 'string')
+            return env.message;
+        if (typeof env.error === 'string')
+            return env.error;
+    }
+    return fallback;
+}
+async function asApiError(res, defaultMessage) {
+    const body = await readJsonSafe(res);
+    let code = null;
+    if (body && typeof body === 'object' && typeof body.error === 'string') {
+        code = body.error || null;
+    }
+    return new ApiError(res.status, code, extractMessage(body, defaultMessage), body);
+}
+async function safeFetch(url, init) {
+    try {
+        return await fetch(url, init);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new NetworkError(message, err);
+    }
+}
+function buildQuery(q) {
+    const params = new URLSearchParams();
+    if (q.q)
+        params.set('q', q.q);
+    if (q.mood)
+        params.set('mood', q.mood);
+    if (q.tag)
+        params.set('tag', q.tag);
+    if (q.featured)
+        params.set('featured', 'true');
+    if (q.limit !== undefined)
+        params.set('limit', String(q.limit));
+    if (q.offset !== undefined)
+        params.set('offset', String(q.offset));
+    const s = params.toString();
+    return s ? `?${s}` : '';
+}
+async function getJsonEnvelope(url, apiKey) {
+    const res = await safeFetch(url, {
+        method: 'GET',
+        headers: { Accept: 'application/json', ...authHeaders(apiKey) },
+    });
+    if (!res.ok)
+        throw await asApiError(res, `request failed (${res.status})`);
+    const body = (await readJsonSafe(res));
+    if (!body || body.status !== 'success') {
+        throw new ApiError(res.status, null, 'unexpected response shape', body);
+    }
+    return body;
+}
+async function listStyles(opts, query = {}) {
+    const url = `${opts.apiBase}/api/graphics/styles${buildQuery(query)}`;
+    return getJsonEnvelope(url, opts.apiKey);
+}
+async function listFormats(opts, query = {}) {
+    const url = `${opts.apiBase}/api/graphics/formats${buildQuery(query)}`;
+    return getJsonEnvelope(url, opts.apiKey);
+}
+async function fetchRecord(url, apiKey, etag) {
+    const headers = {
+        Accept: 'application/json',
+        ...authHeaders(apiKey),
+    };
+    if (etag)
+        headers['If-None-Match'] = etag;
+    const res = await safeFetch(url, { method: 'GET', headers });
+    if (res.status === 304) {
+        return { status: 304, envelope: null, etag };
+    }
+    if (!res.ok)
+        throw await asApiError(res, `request failed (${res.status})`);
+    const body = (await readJsonSafe(res));
+    if (!body || body.status !== 'success') {
+        throw new ApiError(res.status, null, 'unexpected response shape', body);
+    }
+    return {
+        status: 200,
+        envelope: body,
+        etag: res.headers.get('etag'),
+    };
+}
+async function getStyleRecord(opts, slug, etag = null) {
+    const url = `${opts.apiBase}/api/graphics/styles/${encodeURIComponent(slug)}`;
+    return fetchRecord(url, opts.apiKey, etag);
+}
+async function getFormatRecord(opts, slug, etag = null) {
+    const url = `${opts.apiBase}/api/graphics/formats/${encodeURIComponent(slug)}`;
+    return fetchRecord(url, opts.apiKey, etag);
+}
+async function fetchMarkdown(url, apiKey, etag) {
+    const headers = {
+        Accept: 'text/plain',
+        ...authHeaders(apiKey),
+    };
+    if (etag)
+        headers['If-None-Match'] = etag;
+    const res = await safeFetch(url, { method: 'GET', headers });
+    if (res.status === 304) {
+        return { status: 304, body: null, etag };
+    }
+    if (!res.ok)
+        throw await asApiError(res, `request failed (${res.status})`);
+    const body = await res.text();
+    return { status: 200, body, etag: res.headers.get('etag') };
+}
+async function getStyleDesignMd(opts, slug, etag = null) {
+    const url = `${opts.apiBase}/api/graphics/styles/${encodeURIComponent(slug)}/design.md`;
+    return fetchMarkdown(url, opts.apiKey, etag);
+}
+async function getFormatSpecMd(opts, slug, etag = null) {
+    const url = `${opts.apiBase}/api/graphics/formats/${encodeURIComponent(slug)}/spec.md`;
+    return fetchMarkdown(url, opts.apiKey, etag);
+}
+function inferContentType(absolutePath) {
+    const ext = path.extname(absolutePath).toLowerCase();
+    switch (ext) {
+        case '.png':
+            return 'image/png';
+        case '.jpg':
+        case '.jpeg':
+            return 'image/jpeg';
+        case '.webp':
+            return 'image/webp';
+        case '.gif':
+            return 'image/gif';
+        case '.svg':
+            return 'image/svg+xml';
+        default:
+            return 'application/octet-stream';
+    }
+}
+function buildMultipart(manifest, files) {
+    const fd = new FormData();
+    fd.append('manifest', JSON.stringify(manifest));
+    for (const f of files) {
+        const buf = fs.readFileSync(f.absolutePath);
+        // Node's Blob accepts a Uint8Array. We use the file's basename as the
+        // filename, but the field name carries the manifest reference (with "./"
+        // stripped) so the server can match it back to the manifest entry.
+        const ab = buf.buffer.slice(buf.byteOffset, buf.byteOffset + buf.byteLength);
+        // Without a `type`, Node's FormData serialises the part as
+        // `Content-Type: application/octet-stream`, which the server's image
+        // allowlist rejects with a 400.
+        const blob = new Blob([ab], { type: inferContentType(f.absolutePath) });
+        fd.append(f.fieldName, blob, path.basename(f.absolutePath));
+    }
+    return fd;
+}
+async function readWriteResponse(res) {
+    const body = (await readJsonSafe(res));
+    if (!body || body.status !== 'success' || !body.data?.slug || !body.data.id) {
+        throw new ApiError(res.status, null, 'unexpected write response shape', body);
+    }
+    return { slug: body.data.slug, id: body.data.id };
+}
+async function postMultipart(url, apiKey, manifest, files, method) {
+    const fd = buildMultipart(manifest, files);
+    const res = await safeFetch(url, {
+        method,
+        headers: authHeaders(apiKey),
+        body: fd,
+    });
+    if (!res.ok)
+        throw await asApiError(res, `${method} ${url} failed (${res.status})`);
+    return readWriteResponse(res);
+}
+async function publishStyle(opts, manifest, files) {
+    const url = `${opts.apiBase}/api/graphics/styles`;
+    return postMultipart(url, opts.apiKey, manifest, files, 'POST');
+}
+async function updateStyle(opts, slug, manifest, files) {
+    const url = `${opts.apiBase}/api/graphics/styles/${encodeURIComponent(slug)}`;
+    return postMultipart(url, opts.apiKey, manifest, files, 'PATCH');
+}
+async function deleteStyle(opts, slug) {
+    const url = `${opts.apiBase}/api/graphics/styles/${encodeURIComponent(slug)}`;
+    const res = await safeFetch(url, {
+        method: 'DELETE',
+        headers: authHeaders(opts.apiKey),
+    });
+    if (!res.ok)
+        throw await asApiError(res, `DELETE ${url} failed (${res.status})`);
+}
+async function publishFormat(opts, manifest, files) {
+    const url = `${opts.apiBase}/api/graphics/formats`;
+    return postMultipart(url, opts.apiKey, manifest, files, 'POST');
+}
+async function updateFormat(opts, slug, manifest, files) {
+    const url = `${opts.apiBase}/api/graphics/formats/${encodeURIComponent(slug)}`;
+    return postMultipart(url, opts.apiKey, manifest, files, 'PATCH');
+}
+async function deleteFormat(opts, slug) {
+    const url = `${opts.apiBase}/api/graphics/formats/${encodeURIComponent(slug)}`;
+    const res = await safeFetch(url, {
+        method: 'DELETE',
+        headers: authHeaders(opts.apiKey),
+    });
+    if (!res.ok)
+        throw await asApiError(res, `DELETE ${url} failed (${res.status})`);
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Example PNG download (for `get --include-examples`)
+async function downloadBytes(url) {
+    const res = await safeFetch(url, { method: 'GET' });
+    if (!res.ok)
+        throw await asApiError(res, `download failed (${res.status})`);
+    const ab = await res.arrayBuffer();
+    return Buffer.from(ab);
+}
+//# sourceMappingURL=graphics-api.js.map

package/dist/lib/graphics-api.js.map

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

package/dist/lib/graphics-cache.d.ts

@@ -0,0 +1,31 @@
+/**
+ * ETag-keyed disk cache for the graphics design.md/spec.md endpoints.
+ *
+ * Layout:
+ *   ~/.gooseworks/cache/graphics/styles/<slug>.md
+ *   ~/.gooseworks/cache/graphics/styles/<slug>.md.etag
+ *   ~/.gooseworks/cache/graphics/styles/<slug>.json
+ *   ~/.gooseworks/cache/graphics/styles/<slug>.json.etag
+ *   ~/.gooseworks/cache/graphics/formats/<slug>.md
+ *   …
+ *
+ * Freshness is implicit (HTTP ETag handles it); there's no fixed TTL.
+ */
+export type Resource = 'styles' | 'formats';
+export type Variant = 'md' | 'json';
+export interface CacheEntry {
+    body: string;
+    etag: string | null;
+}
+export declare function readCache(resource: Resource, slug: string, variant: Variant): CacheEntry | null;
+/**
+ * Atomically writes the cache body and (optionally) etag. Each file is
+ * written via a PID-suffixed temp file then renamed, so a crash mid-write
+ * never leaves a torn body file readable. Concurrent writers can still
+ * race on body-vs-etag consistency, but that race is self-healing on the
+ * next fetch (mismatched etag → 200 with fresh body → both rewritten).
+ */
+export declare function writeCache(resource: Resource, slug: string, variant: Variant, body: string, etag: string | null): void;
+/** Test seam — exposes the resolved cache root for unit tests. */
+export declare function getCacheRoot(): string;
+//# sourceMappingURL=graphics-cache.d.ts.map

package/dist/lib/graphics-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphics-cache.d.ts","sourceRoot":"","sources":["../../src/lib/graphics-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAC5C,MAAM,MAAM,OAAO,GAAG,IAAI,GAAG,MAAM,CAAC;AAsBpC,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,wBAAgB,SAAS,CACvB,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,GACf,UAAU,GAAG,IAAI,CAcnB;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GAAG,IAAI,GAClB,IAAI,CAeN;AAQD,kEAAkE;AAClE,wBAAgB,YAAY,IAAI,MAAM,CAErC"}

package/dist/lib/graphics-cache.js

@@ -0,0 +1,126 @@
+"use strict";
+/**
+ * ETag-keyed disk cache for the graphics design.md/spec.md endpoints.
+ *
+ * Layout:
+ *   ~/.gooseworks/cache/graphics/styles/<slug>.md
+ *   ~/.gooseworks/cache/graphics/styles/<slug>.md.etag
+ *   ~/.gooseworks/cache/graphics/styles/<slug>.json
+ *   ~/.gooseworks/cache/graphics/styles/<slug>.json.etag
+ *   ~/.gooseworks/cache/graphics/formats/<slug>.md
+ *   …
+ *
+ * Freshness is implicit (HTTP ETag handles it); there's no fixed TTL.
+ */
+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.readCache = readCache;
+exports.writeCache = writeCache;
+exports.getCacheRoot = getCacheRoot;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const graphics_manifest_1 = require("./graphics-manifest");
+function getCacheRootInternal() {
+    return (process.env.GOOSEWORKS_GRAPHICS_CACHE_DIR ||
+        path.join(os.homedir(), '.gooseworks', 'cache', 'graphics'));
+}
+/**
+ * Returns the cache file path for a slug, or null if the slug fails the
+ * public grammar. Returning null instead of throwing means a malformed user
+ * arg falls through to the network layer (which will reject it with a
+ * normal 404), rather than crashing the CLI before any request is made.
+ * The check also blocks path traversal via slugs sourced from server JSON.
+ */
+function pathFor(resource, slug, variant) {
+    if (!graphics_manifest_1.SLUG_RE.test(slug))
+        return null;
+    const ext = variant === 'md' ? '.md' : '.json';
+    return path.join(getCacheRootInternal(), resource, `${slug}${ext}`);
+}
+function readCache(resource, slug, variant) {
+    const bodyPath = pathFor(resource, slug, variant);
+    if (!bodyPath)
+        return null;
+    if (!fs.existsSync(bodyPath))
+        return null;
+    try {
+        const body = fs.readFileSync(bodyPath, 'utf-8');
+        const etagPath = `${bodyPath}.etag`;
+        const etag = fs.existsSync(etagPath)
+            ? fs.readFileSync(etagPath, 'utf-8').trim() || null
+            : null;
+        return { body, etag };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Atomically writes the cache body and (optionally) etag. Each file is
+ * written via a PID-suffixed temp file then renamed, so a crash mid-write
+ * never leaves a torn body file readable. Concurrent writers can still
+ * race on body-vs-etag consistency, but that race is self-healing on the
+ * next fetch (mismatched etag → 200 with fresh body → both rewritten).
+ */
+function writeCache(resource, slug, variant, body, etag) {
+    const bodyPath = pathFor(resource, slug, variant);
+    if (!bodyPath)
+        return;
+    fs.mkdirSync(path.dirname(bodyPath), { recursive: true });
+    atomicWrite(bodyPath, body);
+    const etagPath = `${bodyPath}.etag`;
+    if (etag) {
+        atomicWrite(etagPath, etag);
+    }
+    else if (fs.existsSync(etagPath)) {
+        try {
+            fs.unlinkSync(etagPath);
+        }
+        catch {
+            // best effort
+        }
+    }
+}
+function atomicWrite(target, contents) {
+    const tmp = `${target}.tmp.${process.pid}.${Date.now()}`;
+    fs.writeFileSync(tmp, contents, 'utf-8');
+    fs.renameSync(tmp, target);
+}
+/** Test seam — exposes the resolved cache root for unit tests. */
+function getCacheRoot() {
+    return getCacheRootInternal();
+}
+//# sourceMappingURL=graphics-cache.js.map

package/dist/lib/graphics-cache.js.map

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