@12ui/design 0.2.0

package/dist/cli-auth-command.js

@@ -0,0 +1,100 @@
+import { readStoredConversionCredentials, removeStoredConversionCredentials, resolveCredentialFile, } from './credential-store.js';
+import { setUpConversionCredentials } from './credential-setup.js';
+import { booleanFlag, stringFlag } from './cli-arguments.js';
+import { revokeConvertApiKey, TWELVE_UI_DEVICE_SCOPES, verifyTwelveUiCredential, } from './login-auth.js';
+const readQuota = async (origin, apiKey) => {
+    const response = await fetch(`${origin}/api/v1/convert/quota`, {
+        headers: {
+            Accept: 'application/json',
+            Authorization: `Bearer ${apiKey}`,
+        },
+    });
+    const value = await response.json().catch(() => null);
+    if (!response.ok) {
+        const detail = value !== null && typeof value === 'object'
+            && typeof value.detail === 'string'
+            ? value.detail
+            : `HTTP ${response.status}`;
+        throw new Error(`Unable to read 12ui quota: ${detail}`);
+    }
+    return value;
+};
+const verifyAvailableCredentialScope = async (apiKey, loginOrigin) => {
+    const failures = [];
+    for (const scope of TWELVE_UI_DEVICE_SCOPES) {
+        try {
+            return await verifyTwelveUiCredential({
+                apiKey,
+                loginOrigin,
+                requiredScopes: [scope],
+            });
+        }
+        catch (error) {
+            failures.push(error);
+        }
+    }
+    throw new AggregateError(failures, 'The stored 12ui credential could not be verified for any supported design scope');
+};
+export const runAuthCommand = async (action, flags) => {
+    const loginOrigin = stringFlag(flags, 'login-origin');
+    if (action === 'login') {
+        const credentials = await setUpConversionCredentials({
+            apiKey: stringFlag(flags, 'api-key'),
+            origin: stringFlag(flags, 'origin'),
+            loginOrigin,
+            keyName: stringFlag(flags, 'key-name'),
+            forceAuthentication: stringFlag(flags, 'api-key') === undefined,
+            onApprovalUrl: (url) => {
+                console.log('Authenticate your personal Login account for 12ui Convert:');
+                console.log(url);
+            },
+        });
+        console.log(`Personal Convert credentials ${credentials.source === 'browser' ? 'created' : 'imported'}`
+            + ` and verified at ${credentials.credentialFile}.`);
+        return;
+    }
+    const stored = await readStoredConversionCredentials();
+    if (!stored) {
+        throw new Error(`12ui credentials are not configured at ${resolveCredentialFile()}`);
+    }
+    if (action === 'status') {
+        const verification = await verifyAvailableCredentialScope(stored.apiKey, loginOrigin);
+        const hasConvertScope = verification.scopes.includes('design.convert');
+        const quota = hasConvertScope
+            ? await readQuota(stored.origin, stored.apiKey)
+            : undefined;
+        const result = {
+            status: 'authenticated',
+            accountType: verification.subjectType,
+            accountId: verification.subjectId,
+            credentialId: verification.credentialId,
+            scopes: verification.scopes,
+            credentialFile: resolveCredentialFile(),
+            origin: stored.origin,
+            ...(hasConvertScope ? { quota } : {}),
+        };
+        if (booleanFlag(flags, 'json'))
+            console.log(JSON.stringify(result, null, 2));
+        else {
+            console.log(`Authenticated personal account: ${verification.subjectId}`);
+            console.log(`Credential: ${verification.credentialId}`);
+            console.log(`Scopes: ${verification.scopes.join(', ')}`);
+            console.log(`Origin: ${stored.origin}`);
+            console.log(hasConvertScope
+                ? JSON.stringify(quota, null, 2)
+                : 'Convert quota unavailable: credential does not include design.convert.');
+        }
+        return;
+    }
+    if (action === 'logout') {
+        await revokeConvertApiKey({
+            apiKey: stored.apiKey,
+            loginOrigin,
+        });
+        await removeStoredConversionCredentials();
+        console.log('The personal 12ui credential was revoked and removed from this device.');
+        return;
+    }
+    throw new Error('Usage: 12ui auth <login|status|logout>');
+};
+//# sourceMappingURL=cli-auth-command.js.map

package/dist/cli-auth-command.js.map

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

package/dist/cli-corpus-command.d.ts

@@ -0,0 +1,12 @@
+import { type CliFlags } from './cli-arguments.js';
+import { type InspirationClient } from './cli-corpus-types.js';
+import { readConversionConfig } from './config.js';
+export { downloadCorpusInspiration, resumeCorpusInspiration, } from './cli-corpus-run.js';
+export { CORPUS_USAGE_NOTICE, } from './cli-corpus-types.js';
+export type { CorpusInspirationManifest, DownloadedCorpusReference, } from './cli-corpus-types.js';
+type CorpusCommandDependencies = {
+    readConfig: typeof readConversionConfig;
+    createClient: (config: ReturnType<typeof readConversionConfig>) => InspirationClient;
+};
+export declare const runCorpusCommand: (action: string | undefined, flags: CliFlags, dependencies?: CorpusCommandDependencies) => Promise<void>;
+//# sourceMappingURL=cli-corpus-command.d.ts.map

package/dist/cli-corpus-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-corpus-command.d.ts","sourceRoot":"","sources":["../src/cli-corpus-command.ts"],"names":[],"mappings":"AAGA,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAK/D,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAM/B,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD,OAAO,EACL,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAE/B,KAAK,yBAAyB,GAAG;IAC/B,UAAU,EAAE,OAAO,oBAAoB,CAAC;IACxC,YAAY,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,KAAK,iBAAiB,CAAC;CACtF,CAAC;AAoDF,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,MAAM,GAAG,SAAS,EAC1B,OAAO,QAAQ,EACf,eAAc,yBAGb,KACA,OAAO,CAAC,IAAI,CA+Dd,CAAC"}

package/dist/cli-corpus-command.js

@@ -0,0 +1,120 @@
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { stringFlag } from './cli-arguments.js';
+import { downloadCorpusInspiration, resumeCorpusInspiration, } from './cli-corpus-run.js';
+import { INSPIRATION_MANIFEST_FILE, } from './cli-corpus-types.js';
+import { TwelveUiCorpusClient, } from './corpus-client.js';
+import { readConversionConfig } from './config.js';
+export { downloadCorpusInspiration, resumeCorpusInspiration, } from './cli-corpus-run.js';
+export { CORPUS_USAGE_NOTICE, } from './cli-corpus-types.js';
+const positiveInteger = (value, fallback, name) => {
+    if (value === undefined)
+        return fallback;
+    const parsed = Number(value);
+    if (!Number.isSafeInteger(parsed) || parsed < 1) {
+        throw new Error(`--${name} must be a positive integer`);
+    }
+    return parsed;
+};
+const boundedNumber = (value, fallback, name, minimum, maximum) => {
+    if (value === undefined)
+        return fallback;
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed) || parsed < minimum || parsed > maximum) {
+        throw new Error(`--${name} must be between ${minimum} and ${maximum}`);
+    }
+    return parsed;
+};
+const optionalSeed = (value) => {
+    if (value === undefined)
+        return undefined;
+    const parsed = Number(value);
+    if (!Number.isSafeInteger(parsed) || parsed < 0 || parsed > 0xffff_ffff) {
+        throw new Error('--seed must be an integer between 0 and 4294967295');
+    }
+    return parsed;
+};
+const optionalAspect = (value) => {
+    if (value === undefined)
+        return undefined;
+    if (value === 'portrait' || value === 'landscape' || value === 'square')
+        return value;
+    throw new Error('--aspect must be one of: landscape, square, portrait');
+};
+const readQuery = async (flags) => {
+    const query = stringFlag(flags, 'query')?.trim();
+    const queryFile = stringFlag(flags, 'query-file')?.trim();
+    if (Boolean(query) === Boolean(queryFile)) {
+        throw new Error('Provide exactly one --query or --query-file');
+    }
+    const value = query ?? (await readFile(path.resolve(queryFile), 'utf8')).trim();
+    if (!value)
+        throw new Error('The corpus inspiration query must not be empty');
+    return value;
+};
+export const runCorpusCommand = async (action, flags, dependencies = {
+    readConfig: readConversionConfig,
+    createClient: (config) => new TwelveUiCorpusClient(config),
+}) => {
+    if (action !== 'inspire' && action !== 'resume') {
+        throw new Error('Usage: 12ui corpus inspire --query <text>|--query-file <file>'
+            + ' --out-dir <directory> [--count <1-48>] [--wildness <0-0.6>]'
+            + ' [--seed <integer>] [--aspect landscape|square|portrait]'
+            + ' [--idempotency-key <key>]'
+            + '\n       12ui corpus resume --out-dir <directory>');
+    }
+    if (action === 'inspire' && stringFlag(flags, 'kind') !== undefined) {
+        throw new Error('--kind is not supported by the corpus CLI because unverified values can produce an'
+            + ' empty metered set. Use the SDK only when the exact corpus kind is verified.');
+    }
+    const outDir = stringFlag(flags, 'out-dir')?.trim();
+    if (!outDir)
+        throw new Error('--out-dir is required');
+    const config = dependencies.readConfig({
+        origin: stringFlag(flags, 'origin'),
+        apiKey: stringFlag(flags, 'api-key'),
+    });
+    const client = dependencies.createClient(config);
+    if (action === 'resume') {
+        const manifest = await resumeCorpusInspiration({ client, outDir, origin: config.origin });
+        console.log(JSON.stringify({
+            setId: manifest.response.setId,
+            seed: manifest.response.seed,
+            outDir: path.resolve(outDir),
+            manifest: path.join(path.resolve(outDir), INSPIRATION_MANIFEST_FILE),
+            references: manifest.references,
+        }, null, 2));
+        return;
+    }
+    const count = positiveInteger(stringFlag(flags, 'count'), 4, 'count');
+    if (count > 48)
+        throw new Error('--count must be at most 48');
+    const wildness = boundedNumber(stringFlag(flags, 'wildness'), 0.6, 'wildness', 0, 0.6);
+    const seed = optionalSeed(stringFlag(flags, 'seed'));
+    const aspect = optionalAspect(stringFlag(flags, 'aspect'));
+    const query = await readQuery(flags);
+    const request = {
+        q: query,
+        k: count,
+        tau: wildness,
+        ...(aspect ? { filters: {
+                ...(aspect ? { aspect } : {}),
+            } } : {}),
+        ...(seed !== undefined ? { seed } : {}),
+    };
+    const manifest = await downloadCorpusInspiration({
+        client,
+        request,
+        outDir,
+        origin: config.origin,
+        idempotencyKey: stringFlag(flags, 'idempotency-key'),
+    });
+    console.log(JSON.stringify({
+        setId: manifest.response.setId,
+        seed: manifest.response.seed,
+        outDir: path.resolve(outDir),
+        manifest: path.join(path.resolve(outDir), INSPIRATION_MANIFEST_FILE),
+        references: manifest.references,
+    }, null, 2));
+};
+//# sourceMappingURL=cli-corpus-command.js.map

package/dist/cli-corpus-command.js.map

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

package/dist/cli-corpus-evidence.d.ts

@@ -0,0 +1,17 @@
+import { type CorpusInspirationAttempt, type CorpusInspirationEvidence, type CorpusInspirationManifest, type DownloadedCorpusReference } from './cli-corpus-types.js';
+export declare const validateInspirationSet: (evidence: CorpusInspirationEvidence, outDir: string) => void;
+export declare const writeInspirationAttempt: (outDir: string, attempt: CorpusInspirationAttempt) => Promise<void>;
+export declare const readInspirationAttempt: (outDir: string) => Promise<CorpusInspirationAttempt>;
+export declare const writeInspirationEvidence: (outDir: string, evidence: CorpusInspirationEvidence) => Promise<void>;
+export declare const readInspirationEvidence: (outDir: string) => Promise<CorpusInspirationEvidence>;
+export declare const readOptionalInspirationEvidence: (outDir: string) => Promise<CorpusInspirationEvidence | null>;
+export declare const assertAttemptMatchesEvidence: (attempt: CorpusInspirationAttempt, evidence: CorpusInspirationEvidence) => void;
+export declare const assertInspirationRunIncomplete: (outDir: string) => Promise<void>;
+export declare const writeInspirationManifest: (args: {
+    attempt: CorpusInspirationAttempt;
+    evidence: CorpusInspirationEvidence;
+    references: DownloadedCorpusReference[];
+    outDir: string;
+    now?: () => Date;
+}) => Promise<CorpusInspirationManifest>;
+//# sourceMappingURL=cli-corpus-evidence.d.ts.map

package/dist/cli-corpus-evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-corpus-evidence.d.ts","sourceRoot":"","sources":["../src/cli-corpus-evidence.ts"],"names":[],"mappings":"AAIA,OAAO,EAKL,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAC/B,MAAM,uBAAuB,CAAC;AA4F/B,eAAO,MAAM,sBAAsB,GACjC,UAAU,yBAAyB,EACnC,QAAQ,MAAM,KACb,IAmBF,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAClC,QAAQ,MAAM,EACd,SAAS,wBAAwB,KAChC,OAAO,CAAC,IAAI,CAMd,CAAC;AAEF,eAAO,MAAM,sBAAsB,GACjC,QAAQ,MAAM,KACb,OAAO,CAAC,wBAAwB,CAKlC,CAAC;AAEF,eAAO,MAAM,wBAAwB,GACnC,QAAQ,MAAM,EACd,UAAU,yBAAyB,KAClC,OAAO,CAAC,IAAI,CAMd,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAClC,QAAQ,MAAM,KACb,OAAO,CAAC,yBAAyB,CAKnC,CAAC;AAEF,eAAO,MAAM,+BAA+B,GAC1C,QAAQ,MAAM,KACb,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAO1C,CAAC;AAEF,eAAO,MAAM,4BAA4B,GACvC,SAAS,wBAAwB,EACjC,UAAU,yBAAyB,KAClC,IAIF,CAAC;AAEF,eAAO,MAAM,8BAA8B,GAAU,QAAQ,MAAM,KAAG,OAAO,CAAC,IAAI,CAOjF,CAAC;AAEF,eAAO,MAAM,wBAAwB,GAAU,MAAM;IACnD,OAAO,EAAE,wBAAwB,CAAC;IAClC,QAAQ,EAAE,yBAAyB,CAAC;IACpC,UAAU,EAAE,yBAAyB,EAAE,CAAC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB,KAAG,OAAO,CAAC,yBAAyB,CA2BpC,CAAC"}

package/dist/cli-corpus-evidence.js

@@ -0,0 +1,150 @@
+import { readFile, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { CORPUS_USAGE_NOTICE, INSPIRATION_ATTEMPT_FILE, INSPIRATION_EVIDENCE_FILE, INSPIRATION_MANIFEST_FILE, } from './cli-corpus-types.js';
+const isRecord = (value) => (typeof value === 'object' && value !== null && !Array.isArray(value));
+const isErrno = (error, code) => (error instanceof Error && 'code' in error && error.code === code);
+const isCorpusAspect = (value) => (value === 'portrait' || value === 'landscape' || value === 'square');
+const validInspirationRequest = (request) => (typeof request.q === 'string'
+    && Boolean(request.q.trim())
+    && (request.k === undefined
+        || (typeof request.k === 'number'
+            && Number.isSafeInteger(request.k)
+            && request.k >= 1)));
+const parseInspirationAttempt = (value) => {
+    if (!isRecord(value)
+        || value.version !== 1
+        || typeof value.createdAt !== 'string'
+        || !Number.isFinite(Date.parse(value.createdAt))
+        || typeof value.origin !== 'string'
+        || !/^https?:\/\//u.test(value.origin)
+        || typeof value.idempotencyKey !== 'string'
+        || !value.idempotencyKey.trim()
+        || value.idempotencyKey.length > 128
+        || /[\u0000-\u001f\u007f]/u.test(value.idempotencyKey)
+        || !isRecord(value.request)
+        || !validInspirationRequest(value.request)) {
+        throw new Error('Corpus inspiration attempt evidence is invalid');
+    }
+    return value;
+};
+const parseInspirationEvidence = (value) => {
+    if (!isRecord(value) || value.version !== 1 || !isRecord(value.request) || !isRecord(value.response)) {
+        throw new Error('Corpus inspiration evidence is invalid');
+    }
+    const request = value.request;
+    const response = value.response;
+    if (!validInspirationRequest(request)) {
+        throw new Error('Corpus inspiration request evidence is invalid');
+    }
+    if (typeof response.setId !== 'string'
+        || typeof response.query !== 'string'
+        || typeof response.seed !== 'number'
+        || !Number.isSafeInteger(response.seed)
+        || typeof response.k !== 'number'
+        || !Number.isSafeInteger(response.k)
+        || typeof response.poolSize !== 'number'
+        || !Number.isSafeInteger(response.poolSize)
+        || typeof response.coverage !== 'number'
+        || !Number.isFinite(response.coverage)
+        || typeof response.truncated !== 'boolean'
+        || response.weightsSource !== 'default:owner-elite12'
+        || !Array.isArray(response.items)) {
+        throw new Error('Corpus inspiration response evidence is invalid');
+    }
+    const validItems = response.items.every((item) => (isRecord(item)
+        && typeof item.id === 'string'
+        && /^(?:gen|logo-gen)-[A-Za-z0-9._-]{1,120}$/u.test(item.id)
+        && (item.role === 'core' || item.role === 'stretch')
+        && typeof item.arm === 'string'
+        && (item.cell === null || typeof item.cell === 'string')
+        && isCorpusAspect(item.aspect)
+        && typeof item.relevance === 'number'
+        && Number.isFinite(item.relevance)
+        && typeof item.relevancePercentile === 'number'
+        && Number.isFinite(item.relevancePercentile)
+        && typeof item.qualityPercentile === 'number'
+        && Number.isFinite(item.qualityPercentile)));
+    if (!validItems)
+        throw new Error('Corpus inspiration item evidence is invalid');
+    return value;
+};
+export const validateInspirationSet = (evidence, outDir) => {
+    const expectedCount = evidence.request.k ?? 24;
+    const { response } = evidence;
+    if (response.k !== expectedCount) {
+        throw new Error(`Corpus inspiration response expected ${response.k} references but request expected`
+            + ` ${expectedCount}; evidence is in ${outDir}`);
+    }
+    if (response.truncated || response.items.length !== expectedCount) {
+        throw new Error(`Corpus inspiration returned ${response.items.length} of ${expectedCount} references`
+            + `${response.truncated ? ' (truncated)' : ''}; evidence is in ${outDir}`);
+    }
+    const ids = response.items.map((item) => item.id);
+    if (new Set(ids).size !== ids.length) {
+        throw new Error(`Corpus inspiration returned duplicate reference ids; evidence is in ${outDir}`);
+    }
+};
+export const writeInspirationAttempt = async (outDir, attempt) => {
+    await writeFile(path.join(outDir, INSPIRATION_ATTEMPT_FILE), `${JSON.stringify(attempt, null, 2)}\n`, { flag: 'wx' });
+};
+export const readInspirationAttempt = async (outDir) => {
+    const raw = JSON.parse(await readFile(path.join(outDir, INSPIRATION_ATTEMPT_FILE), 'utf8'));
+    return parseInspirationAttempt(raw);
+};
+export const writeInspirationEvidence = async (outDir, evidence) => {
+    await writeFile(path.join(outDir, INSPIRATION_EVIDENCE_FILE), `${JSON.stringify(evidence, null, 2)}\n`, { flag: 'wx' });
+};
+export const readInspirationEvidence = async (outDir) => {
+    const rawEvidence = JSON.parse(await readFile(path.join(outDir, INSPIRATION_EVIDENCE_FILE), 'utf8'));
+    return parseInspirationEvidence(rawEvidence);
+};
+export const readOptionalInspirationEvidence = async (outDir) => {
+    try {
+        return await readInspirationEvidence(outDir);
+    }
+    catch (error) {
+        if (isErrno(error, 'ENOENT'))
+            return null;
+        throw error;
+    }
+};
+export const assertAttemptMatchesEvidence = (attempt, evidence) => {
+    if (JSON.stringify(attempt.request) !== JSON.stringify(evidence.request)) {
+        throw new Error('Corpus inspiration attempt and response evidence requests do not match');
+    }
+};
+export const assertInspirationRunIncomplete = async (outDir) => {
+    try {
+        await readFile(path.join(outDir, INSPIRATION_MANIFEST_FILE));
+        throw new Error(`Corpus inspiration run is already complete: ${outDir}`);
+    }
+    catch (error) {
+        if (!isErrno(error, 'ENOENT'))
+            throw error;
+    }
+};
+export const writeInspirationManifest = async (args) => {
+    const { request, response } = args.evidence;
+    const manifest = {
+        version: 1,
+        createdAt: (args.now ?? (() => new Date()))().toISOString(),
+        origin: args.attempt.origin,
+        idempotencyKey: args.attempt.idempotencyKey,
+        notice: CORPUS_USAGE_NOTICE,
+        request,
+        response: {
+            setId: response.setId,
+            query: response.query,
+            seed: response.seed,
+            k: response.k,
+            poolSize: response.poolSize,
+            coverage: response.coverage,
+            truncated: response.truncated,
+            weightsSource: response.weightsSource,
+        },
+        references: args.references,
+    };
+    await writeFile(path.join(args.outDir, INSPIRATION_MANIFEST_FILE), `${JSON.stringify(manifest, null, 2)}\n`, { flag: 'wx' });
+    return manifest;
+};
+//# sourceMappingURL=cli-corpus-evidence.js.map

package/dist/cli-corpus-evidence.js.map

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

package/dist/cli-corpus-reference-downloads.d.ts

@@ -0,0 +1,8 @@
+import { type CorpusInspirationEvidence, type DownloadedCorpusReference, type ReferenceClient } from './cli-corpus-types.js';
+export declare const completeReferenceDownloads: (args: {
+    client: ReferenceClient;
+    evidence: CorpusInspirationEvidence;
+    outDir: string;
+    origin: string;
+}) => Promise<DownloadedCorpusReference[]>;
+//# sourceMappingURL=cli-corpus-reference-downloads.d.ts.map

package/dist/cli-corpus-reference-downloads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-corpus-reference-downloads.d.ts","sourceRoot":"","sources":["../src/cli-corpus-reference-downloads.ts"],"names":[],"mappings":"AAgBA,OAAO,EAEL,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAC9B,KAAK,eAAe,EACrB,MAAM,uBAAuB,CAAC;AAmH/B,eAAO,MAAM,0BAA0B,GAAU,MAAM;IACrD,MAAM,EAAE,eAAe,CAAC;IACxB,QAAQ,EAAE,yBAAyB,CAAC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,KAAG,OAAO,CAAC,yBAAyB,EAAE,CA4CtC,CAAC"}

package/dist/cli-corpus-reference-downloads.js

@@ -0,0 +1,111 @@
+import { createHash } from 'node:crypto';
+import { mkdir, readFile } from 'node:fs/promises';
+import path from 'node:path';
+import sharp from 'sharp';
+import { ensureReferenceDownloadIntent, loadReferenceProvenance, publishReferenceImage, receiptMatchesReference, referenceReceiptPaths, writeReferenceReceipt, } from './cli-corpus-reference-receipts.js';
+import { REFERENCE_RECEIPT_DIRECTORY, } from './cli-corpus-types.js';
+const sha256 = (bytes) => (createHash('sha256').update(bytes).digest('hex'));
+const isErrno = (error, code) => (error instanceof Error && 'code' in error && error.code === code);
+const readOptionalFile = async (file) => {
+    try {
+        return await readFile(file);
+    }
+    catch (error) {
+        if (isErrno(error, 'ENOENT'))
+            return null;
+        throw error;
+    }
+};
+const referenceFromBytes = async (args) => {
+    let metadata;
+    try {
+        metadata = await sharp(args.bytes, { animated: false, failOn: 'warning' }).metadata();
+    }
+    catch (error) {
+        throw new Error(`${args.source === 'existing' ? 'Existing' : 'Downloaded'} corpus reference`
+            + ` ${args.item.id} is not a decodable WebP image`
+            + `${args.source === 'existing' ? '; refusing to overwrite it' : ''}`, { cause: error });
+    }
+    if (metadata.format !== 'webp' || !metadata.width || !metadata.height) {
+        throw new Error(`${args.source === 'existing' ? 'Existing' : 'Downloaded'} corpus reference`
+            + ` ${args.item.id} is not a decodable WebP image`
+            + `${args.source === 'existing' ? '; refusing to overwrite it' : ''}`);
+    }
+    return {
+        ordinal: args.index + 1,
+        id: args.item.id,
+        role: args.item.role,
+        arm: args.item.arm,
+        aspect: args.item.aspect,
+        file: args.file,
+        sha256: sha256(args.bytes),
+        bytes: args.bytes.byteLength,
+        width: metadata.width,
+        height: metadata.height,
+    };
+};
+const readExistingReference = async (paths, item, index, receipt) => {
+    const bytes = await readOptionalFile(paths.image);
+    if (!bytes)
+        return null;
+    if (!receipt) {
+        throw new Error(`Existing corpus reference ${item.id} has no durable digest receipt;`
+            + ' its origin is ambiguous and it will not be overwritten');
+    }
+    const reference = await referenceFromBytes({
+        bytes,
+        file: paths.image,
+        item,
+        index,
+        source: 'existing',
+    });
+    if (!receiptMatchesReference(receipt, reference)) {
+        throw new Error(`Existing corpus reference ${item.id} does not match its durable digest receipt;`
+            + ' refusing to overwrite ambiguous evidence');
+    }
+    return reference;
+};
+const downloadReference = async (client, paths, item, index, intent, expectedReceipt) => {
+    const bytes = await client.download(item.id, 'ref');
+    const reference = await referenceFromBytes({
+        bytes,
+        file: paths.image,
+        item,
+        index,
+        source: 'downloaded',
+    });
+    if (expectedReceipt && !receiptMatchesReference(expectedReceipt, reference)) {
+        throw new Error(`Downloaded corpus reference ${item.id} does not match its durable digest receipt;`
+            + ' refusing changed source bytes');
+    }
+    if (!expectedReceipt)
+        await writeReferenceReceipt(paths, intent, reference);
+    await publishReferenceImage(paths, bytes);
+    return reference;
+};
+export const completeReferenceDownloads = async (args) => {
+    await mkdir(path.join(args.outDir, REFERENCE_RECEIPT_DIRECTORY), { recursive: true });
+    const settled = await Promise.allSettled(args.evidence.response.items.map(async (item, index) => {
+        const paths = referenceReceiptPaths(args.outDir, item, index);
+        const provenance = await loadReferenceProvenance(paths, item, index);
+        const existing = await readExistingReference(paths, item, index, provenance.receipt);
+        if (existing)
+            return existing;
+        const intent = await ensureReferenceDownloadIntent(paths, item, index, provenance.intent);
+        return await downloadReference(args.client, paths, item, index, intent, provenance.receipt);
+    }));
+    const failures = settled.flatMap((result) => (result.status === 'rejected' ? [result.reason] : []));
+    if (failures.length > 0) {
+        const details = failures.map((failure) => (failure instanceof Error ? failure.message : String(failure))).join('; ');
+        throw new AggregateError(failures, `Failed to complete ${failures.length} corpus reference download`
+            + `${failures.length === 1 ? '' : 's'}: ${details}; resume with`
+            + ` "12ui corpus resume --out-dir ${args.outDir} --origin ${args.origin}"`);
+    }
+    return settled.map((result) => {
+        if (result.status === 'rejected') {
+            throw new Error('Unreachable rejected corpus reference result');
+        }
+        return result.value;
+    });
+};
+//# sourceMappingURL=cli-corpus-reference-downloads.js.map

package/dist/cli-corpus-reference-downloads.js.map

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

package/dist/cli-corpus-reference-receipts.d.ts

@@ -0,0 +1,36 @@
+import type { CorpusInspirationItem } from './corpus-client.js';
+import { type DownloadedCorpusReference } from './cli-corpus-types.js';
+type ReferenceDownloadIntent = {
+    version: 1;
+    ordinal: number;
+    id: string;
+    file: string;
+    nonce: string;
+};
+export type CorpusReferenceReceipt = {
+    version: 1;
+    ordinal: number;
+    id: string;
+    file: string;
+    intentNonce: string;
+    sha256: string;
+    bytes: number;
+    width: number;
+    height: number;
+};
+export type ReferenceReceiptPaths = {
+    image: string;
+    intent: string;
+    receipt: string;
+};
+export declare const referenceReceiptPaths: (outDir: string, item: CorpusInspirationItem, index: number) => ReferenceReceiptPaths;
+export declare const loadReferenceProvenance: (paths: ReferenceReceiptPaths, item: CorpusInspirationItem, index: number) => Promise<{
+    intent: ReferenceDownloadIntent | null;
+    receipt: CorpusReferenceReceipt | null;
+}>;
+export declare const ensureReferenceDownloadIntent: (paths: ReferenceReceiptPaths, item: CorpusInspirationItem, index: number, existing: ReferenceDownloadIntent | null) => Promise<ReferenceDownloadIntent>;
+export declare const writeReferenceReceipt: (paths: ReferenceReceiptPaths, intent: ReferenceDownloadIntent, reference: DownloadedCorpusReference) => Promise<CorpusReferenceReceipt>;
+export declare const publishReferenceImage: (paths: ReferenceReceiptPaths, bytes: Uint8Array) => Promise<void>;
+export declare const receiptMatchesReference: (receipt: CorpusReferenceReceipt, reference: DownloadedCorpusReference) => boolean;
+export {};
+//# sourceMappingURL=cli-corpus-reference-receipts.d.ts.map

package/dist/cli-corpus-reference-receipts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-corpus-reference-receipts.d.ts","sourceRoot":"","sources":["../src/cli-corpus-reference-receipts.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,uBAAuB,CAAC;AAE/B,KAAK,uBAAuB,GAAG;IAC7B,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AA8CF,eAAO,MAAM,qBAAqB,GAChC,QAAQ,MAAM,EACd,MAAM,qBAAqB,EAC3B,OAAO,MAAM,KACZ,qBAOF,CAAC;AAsDF,eAAO,MAAM,uBAAuB,GAClC,OAAO,qBAAqB,EAC5B,MAAM,qBAAqB,EAC3B,OAAO,MAAM,KACZ,OAAO,CAAC;IACT,MAAM,EAAE,uBAAuB,GAAG,IAAI,CAAC;IACvC,OAAO,EAAE,sBAAsB,GAAG,IAAI,CAAC;CACxC,CAkBA,CAAC;AAEF,eAAO,MAAM,6BAA6B,GACxC,OAAO,qBAAqB,EAC5B,MAAM,qBAAqB,EAC3B,OAAO,MAAM,EACb,UAAU,uBAAuB,GAAG,IAAI,KACvC,OAAO,CAAC,uBAAuB,CASjC,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAChC,OAAO,qBAAqB,EAC5B,QAAQ,uBAAuB,EAC/B,WAAW,yBAAyB,KACnC,OAAO,CAAC,sBAAsB,CAchC,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAChC,OAAO,qBAAqB,EAC5B,OAAO,UAAU,KAChB,OAAO,CAAC,IAAI,CAAmD,CAAC;AAEnE,eAAO,MAAM,uBAAuB,GAClC,SAAS,sBAAsB,EAC/B,WAAW,yBAAyB,KACnC,OAQF,CAAC"}