@package-broker/cli 0.19.8 → 2.0.0-rc.2

package/dist/commands/built-manifest.js

@@ -0,0 +1,197 @@
+import { readFile } from 'node:fs/promises';
+import { resolve, sep } from 'node:path';
+import { diagnoseRoutes } from '../manifest.js';
+import { planMigrations } from '@package-broker/db-sqlite/migrations/plan';
+import { loadMigrationSource, } from '@package-broker/db-sqlite/migrations/source';
+export class BuiltManifestError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'BuiltManifestError';
+    }
+}
+export class LegacyRouteTableError extends BuiltManifestError {
+    constructor() {
+        super('manifest route table predates route boundaries; run pb build again');
+        this.name = 'LegacyRouteTableError';
+    }
+}
+const ID = /^([a-z0-9-]+):(\d{4}_[a-z0-9_]+)$/;
+const NAME = /^\d{4}_[a-z0-9_]+\.sql$/;
+const CHECKSUM = /^[0-9a-f]{64}$/;
+function describeEntry(raw, index) {
+    const id = typeof raw === 'object' && raw !== null ? raw.id : undefined;
+    return typeof id === 'string' ? `entry ${index} (${JSON.stringify(id)})` : `entry ${index}`;
+}
+function parseEntry(raw, index) {
+    const label = describeEntry(raw, index);
+    if (typeof raw !== 'object' || raw === null || Array.isArray(raw)) {
+        throw new BuiltManifestError(`${label}: must be an object`);
+    }
+    const { id, name, checksum, phase } = raw;
+    if (typeof id !== 'string')
+        throw new BuiltManifestError(`${label}: id must be a string`);
+    if (typeof name !== 'string')
+        throw new BuiltManifestError(`${label}: name must be a string`);
+    if (typeof checksum !== 'string') {
+        throw new BuiltManifestError(`${label}: checksum must be a string`);
+    }
+    if (phase !== 'expand' && phase !== 'contract') {
+        throw new BuiltManifestError(`${label}: phase must be "expand" or "contract"`);
+    }
+    const idMatch = ID.exec(id);
+    if (idMatch === null)
+        throw new BuiltManifestError(`${label}: invalid id`);
+    if (!NAME.test(name))
+        throw new BuiltManifestError(`${label}: invalid name`);
+    if (!CHECKSUM.test(checksum)) {
+        throw new BuiltManifestError(`${label}: checksum must be 64 lowercase hex characters`);
+    }
+    const owner = idMatch[1];
+    if (id !== `${owner}:${name.slice(0, -'.sql'.length)}`) {
+        throw new BuiltManifestError(`${label}: id does not match name`);
+    }
+    return { id, name, checksum, phase, owner };
+}
+async function readManifest(outDir) {
+    const path = resolve(outDir, 'generated', 'manifest.json');
+    let parsed;
+    try {
+        parsed = JSON.parse(await readFile(path, 'utf8'));
+    }
+    catch (error) {
+        throw new BuiltManifestError(`cannot read manifest ${path}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    if (typeof parsed !== 'object' || parsed === null) {
+        throw new BuiltManifestError('manifest must be an object');
+    }
+    const { schemaVersion, migrations } = parsed;
+    if (schemaVersion !== 1)
+        throw new BuiltManifestError('manifest schemaVersion must be 1');
+    if (!Array.isArray(migrations))
+        throw new BuiltManifestError('manifest migrations must be an array');
+    return migrations;
+}
+async function loadEntry(root, entry, label) {
+    const path = resolve(root, entry.owner, entry.name);
+    if (!path.startsWith(root + sep)) {
+        throw new BuiltManifestError(`${label}: path escapes the migrations directory`);
+    }
+    let source;
+    try {
+        source = await loadMigrationSource(entry.owner, entry.name, await readFile(path, 'utf8'));
+    }
+    catch (error) {
+        throw new BuiltManifestError(`${label}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    if (source.checksum !== entry.checksum) {
+        throw new BuiltManifestError(`${label}: checksum does not match the file`);
+    }
+    if (source.phase !== entry.phase) {
+        throw new BuiltManifestError(`${label}: phase does not match the file`);
+    }
+    return source;
+}
+export async function loadBuiltMigrations(outDir) {
+    const rawEntries = await readManifest(outDir);
+    const root = resolve(outDir, 'migrations');
+    const seen = new Set();
+    const owners = [];
+    const sources = [];
+    for (const [index, raw] of rawEntries.entries()) {
+        const entry = parseEntry(raw, index);
+        const label = describeEntry(raw, index);
+        if (seen.has(entry.id))
+            throw new BuiltManifestError(`${label}: duplicate id`);
+        seen.add(entry.id);
+        if (!owners.includes(entry.owner))
+            owners.push(entry.owner);
+        sources.push(await loadEntry(root, entry, label));
+    }
+    try {
+        return await planMigrations(sources, owners);
+    }
+    catch (error) {
+        throw new BuiltManifestError(error instanceof Error ? error.message : String(error));
+    }
+}
+const PACKAGE_PLACEHOLDER = { ecosystem: 'composer', name: () => null };
+function parseRoute(raw, index) {
+    const label = `route ${index}`;
+    if (typeof raw !== 'object' || raw === null || Array.isArray(raw)) {
+        throw new BuiltManifestError(`${label}: must be an object`);
+    }
+    const { method, path, plugin, permission, boundary, needsOrg } = raw;
+    const flag = raw.package;
+    if (typeof method !== 'string')
+        throw new BuiltManifestError(`${label}: method must be a string`);
+    if (typeof path !== 'string')
+        throw new BuiltManifestError(`${label}: path must be a string`);
+    if (typeof plugin !== 'string')
+        throw new BuiltManifestError(`${label}: plugin must be a string`);
+    if (permission !== null && typeof permission !== 'string') {
+        throw new BuiltManifestError(`${label}: permission must be a string or null`);
+    }
+    if (boundary !== undefined && boundary !== null && typeof boundary !== 'string') {
+        throw new BuiltManifestError(`${label}: boundary must be a string`);
+    }
+    if (needsOrg !== undefined && typeof needsOrg !== 'boolean') {
+        throw new BuiltManifestError(`${label}: needsOrg must be a boolean`);
+    }
+    if (flag !== undefined && flag !== true) {
+        throw new BuiltManifestError(`${label}: package must be true when present`);
+    }
+    return {
+        method: method,
+        path,
+        plugin,
+        permission,
+        handler: () => new Response(null),
+        ...(boundary === undefined || boundary === null ? {} : { boundary: boundary }),
+        ...(needsOrg === undefined ? {} : { needsOrg }),
+        ...(flag === true ? { package: PACKAGE_PLACEHOLDER } : {}),
+    };
+}
+export async function loadBuiltRoutes(outDir) {
+    const path = resolve(outDir, 'generated', 'manifest.json');
+    let parsed;
+    try {
+        parsed = JSON.parse(await readFile(path, 'utf8'));
+    }
+    catch (error) {
+        throw new BuiltManifestError(`cannot read manifest ${path}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const routes = parsed?.routes;
+    if (routes === undefined)
+        return null;
+    if (!Array.isArray(routes))
+        throw new BuiltManifestError('manifest routes must be an array');
+    const entries = routes.map((raw, index) => parseRoute(raw, index));
+    if (entries.some((route) => route.permission !== null && route.boundary === undefined)) {
+        throw new LegacyRouteTableError();
+    }
+    return entries;
+}
+export async function builtRouteProblems(outDir) {
+    const routes = await loadBuiltRoutes(outDir);
+    return routes === null ? null : diagnoseRoutes(routes);
+}
+export async function routesAreValid(outDir) {
+    let problems;
+    try {
+        problems = await builtRouteProblems(outDir);
+    }
+    catch (error) {
+        if (!(error instanceof LegacyRouteTableError))
+            throw error;
+        console.error(`error: ${error.message}`);
+        return false;
+    }
+    if (problems === null) {
+        console.error('warning: manifest has no route table; route permissions were not checked');
+        return true;
+    }
+    for (const problem of problems)
+        console.error(`error: ${problem}`.replace(/[\r\n]+/g, ' '));
+    return problems.length === 0;
+}
+//# sourceMappingURL=built-manifest.js.map

package/dist/commands/built-manifest.js.map

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

package/dist/commands/cloudflare/api.d.ts

@@ -0,0 +1,132 @@
+import type { BuildInfo } from '../../build-artifacts.js';
+export type ErrorCode = 'prebuilt_invalid' | 'prebuilt_dirty' | 'prebuilt_git_sha_mismatch' | 'prebuilt_lockfile_mismatch' | 'prebuilt_dependencies_refused' | 'prebuilt_io_failure' | 'prebuilt_unavailable' | 'prebuilt_version_mismatch' | 'prebuilt_unverifiable' | 'checksum_mismatch' | 'migrations_pending' | 'invalid_input' | 'unsafe_path' | 'invalid_inventory' | 'state_io_failure' | 'install_locked' | 'confirmation_required' | 'confirmation_declined' | 'plan_changed' | 'deadline_exceeded' | 'ownership_conflict' | 'jurisdiction_conflict' | 'configuration_conflict' | 'outcome_unknown' | 'provider_failure' | 'permission_denied' | 'capacity_exceeded' | 'capability_unknown' | 'domain_zone_not_found' | 'domain_zone_ambiguous' | 'domain_zone_not_supported' | 'queues_unavailable' | 'workers_paid_required' | 'workers_dev_subdomain_missing' | 'r2_unavailable' | 'analytics_engine_unavailable' | 'migration_failed' | 'smoke_failed' | 'rollback_blocked_contract' | 'rollback_unavailable_first_deploy' | 'rollback_failed' | 'organization_slug_mismatch' | 'organization_not_found' | 'key_recovery_required' | 'token_refresh_required' | 'provider_anchor_changed';
+export declare class CloudflareError extends Error {
+    readonly code: ErrorCode;
+    readonly exitCode: number;
+    readonly retryable: boolean;
+    readonly stage: string;
+    readonly status: number | null;
+    readonly check: 'queues' | 'r2' | 'analytics_engine' | 'provider_contract' | null;
+    readonly providerCode: number | null;
+    readonly source: string | null;
+    readonly fields: readonly string[];
+    constructor(code: ErrorCode, exitCode?: number, retryable?: boolean, stage?: string, status?: number | null, check?: 'queues' | 'r2' | 'analytics_engine' | 'provider_contract' | null, providerCode?: number | null, source?: string | null, fields?: readonly string[]);
+}
+export declare class GitWorktreeRequiredError extends CloudflareError {
+    constructor();
+}
+export interface PlanEntry {
+    stage: string;
+    action: string;
+    kind?: string;
+    name?: string;
+    jurisdiction?: 'eu' | 'default';
+}
+export declare function commandEnvelope(command: string, dryRun?: boolean): {
+    schema_version: 1;
+    command: string;
+    status: "ok" | "planned" | "error";
+    dry_run: boolean;
+    worker_url: string | null;
+    version_id: string | null;
+    previous_version_id: string | null;
+    database_id: string | null;
+    kv_namespace_id: null;
+    r2_bucket: string | null;
+    queue_names: string[];
+    migrations_applied: string[];
+    build_info: BuildInfo | null;
+    artifact_sha256: string | null;
+    pending_migrations: string[];
+    remote_state: "absent" | "present" | null;
+    plan: PlanEntry[];
+    checks: CommandCheck[];
+    rollback: {
+        status: string;
+        target_version_id: string | null;
+    };
+    bootstrap_url: string | null;
+    error: {
+        code: ErrorCode;
+        message: string;
+        retryable: boolean;
+        stage: string;
+    } | null;
+} & {
+    prebuilt?: {
+        package: string;
+        version: string;
+        gitSha: string;
+        artifact_sha256: string;
+    };
+};
+export type CommandEnvelope = ReturnType<typeof commandEnvelope>;
+export interface CommandCheck {
+    name: string;
+    status: string;
+    enabled?: boolean;
+    previews_enabled?: boolean;
+    attempt?: number;
+    elapsed_ms?: number;
+    source?: string;
+}
+export interface CommandResult {
+    exitCode: number;
+    output: CommandEnvelope;
+}
+export declare function failCommand(output: CommandEnvelope, error: unknown): CommandResult;
+export interface ApiOptions {
+    accountId: string;
+    apiToken: string;
+    fetch?: typeof fetch;
+    now?: () => number;
+    sleep?: (ms: number) => Promise<void>;
+    jitter?: () => number;
+    deadline?: number;
+    /** A caller-owned absolute recovery bound, independent of an exhausted probe budget. */
+    recoveryDeadline?: () => number;
+    /** Recovery mutations can use the remaining bounded budget after durable intent is saved. */
+    minimumMutationBudgetMs?: number;
+}
+export type ApiMethod = 'GET' | 'POST' | 'PUT' | 'PATCH';
+export interface ApiResponse {
+    result: unknown;
+    result_info?: Record<string, unknown>;
+}
+export declare function object(value: unknown): Record<string, unknown>;
+export declare function cloudflareCredentials(env: Readonly<Record<string, string | undefined>>): {
+    accountId: string;
+    apiToken: string;
+};
+export declare const CREATE_SETTLE_MS: number;
+/** True only when the client refused a mutation locally, before any byte reached the transport. */
+export declare function wasNotSent(error: unknown): boolean;
+export declare class CloudflareApi {
+    private readonly options;
+    readonly now: () => number;
+    readonly sleep: (ms: number) => Promise<void>;
+    private budgetEnd;
+    private readonly fixedDeadline;
+    private readonly scheduler;
+    constructor(options: ApiOptions);
+    get deadline(): number;
+    get accountId(): string;
+    restartDeadline(budgetMs?: number): void;
+    /** Each recovery mutation keeps its full settle reserve plus its own read-back allowance. */
+    reserveRecovery(mutations: number): void;
+    assertCreateBudget(): void;
+    pause(ms: number): Promise<void>;
+    request(path: string, method?: ApiMethod, body?: unknown, headers?: Record<string, string>): Promise<ApiResponse>;
+    analyticsEngineTables(): Promise<void>;
+    requestZone(zone: string, path: string, method?: ApiMethod, body?: unknown): Promise<ApiResponse>;
+    listZones(name: string): Promise<Record<string, unknown>[]>;
+    uploadAssets(body: FormData, sessionToken: string): Promise<ApiResponse>;
+    private enqueue;
+    private send;
+    /** A collection whose documented response is one array without pagination metadata. */
+    snapshot(path: string): Promise<Record<string, unknown>[]>;
+    snapshotZone(zone: string, path: string): Promise<Record<string, unknown>[]>;
+    list(path: string, field?: string, headers?: Record<string, string>): Promise<Record<string, unknown>[]>;
+}
+export declare function paginatedList(path: string, read: (path: string) => Promise<ApiResponse>, field?: string, unknown?: () => never, malformed?: () => never, perPage?: number): Promise<Record<string, unknown>[]>;
+//# sourceMappingURL=api.d.ts.map

package/dist/commands/cloudflare/api.d.ts.map

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