@butterbase/cli 0.3.5 → 0.5.0

package/dist/src/lib/repo-api.d.ts

@@ -0,0 +1,123 @@
+export interface FileEntry {
+    path: string;
+    sha256: string;
+    size: number;
+    mode?: number;
+}
+export interface PrepareResponse {
+    snapshot_id: string;
+    total_bytes: number;
+    file_count: number;
+    missing_blobs: {
+        sha256: string;
+        uploadUrl: string;
+    }[];
+}
+export interface CommitResponse {
+    snapshot_id: string;
+    total_bytes: number;
+    file_count: number;
+}
+export interface Manifest {
+    files: FileEntry[];
+    message?: string;
+}
+export interface SnapshotResponse {
+    snapshot_id: string;
+    manifest: Manifest;
+}
+export interface SnapshotListItem {
+    snapshot_id: string;
+    created_at: string;
+}
+export interface BlobUrlResponse {
+    sha256: string;
+    size: number;
+    downloadUrl: string;
+    expiresIn: number;
+}
+export interface CloneJob {
+    job_id: string;
+    status: 'pending' | 'processing' | 'completed' | 'failed';
+    source_app_id: string;
+    dest_app_id: string | null;
+    retry_count: number;
+    error_message: string | null;
+    created_at: string;
+    completed_at: string | null;
+    warnings: string[];
+}
+export interface TemplateRow {
+    app_id: string;
+    name: string;
+    region: string;
+    owner_id: string;
+    owner_display_name: string | null;
+    created_at: string;
+    fork_count: number;
+    has_repo: boolean;
+    schema_summary: {
+        table_count: number;
+        function_count: number;
+    };
+}
+export interface ListTemplatesResponse {
+    items: TemplateRow[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+export declare const repoApi: {
+    prepare(appId: string, body: {
+        files: FileEntry[];
+        message?: string;
+    }): Promise<PrepareResponse>;
+    commit(appId: string, manifest: {
+        files: FileEntry[];
+        message?: string;
+    }): Promise<CommitResponse>;
+    getLatest(appId: string): Promise<SnapshotResponse>;
+    getSnapshot(appId: string, snapshotId: string): Promise<SnapshotResponse>;
+    listSnapshots(appId: string): Promise<{
+        snapshots: SnapshotListItem[];
+    }>;
+    getBlobUrl(appId: string, sha256: string): Promise<BlobUrlResponse>;
+    batchBlobUrls(appId: string, shas: string[]): Promise<{
+        blobs: {
+            sha256: string;
+            size: number;
+            downloadUrl: string;
+            expiresIn: number;
+        }[];
+    }>;
+    wipe(appId: string): Promise<{
+        message: string;
+        app_id: string;
+    }>;
+};
+export declare const cloneApi: {
+    create(sourceAppId: string, body: {
+        name?: string;
+        region?: string;
+    }): Promise<{
+        job_id: string;
+        status: string;
+    }>;
+    get(jobId: string): Promise<CloneJob>;
+    retry(jobId: string): Promise<{
+        job_id: string;
+        status: string;
+    }>;
+    listTemplates(opts?: {
+        q?: string;
+        sort?: "recent" | "popular";
+        region?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<ListTemplatesResponse>;
+};
+/** Raw PUT to a presigned S3 URL. No auth header — URL is signed. */
+export declare function uploadBlob(presignedUrl: string, body: Buffer): Promise<void>;
+/** Fetch a blob via the presigned GET URL returned by getBlobUrl. */
+export declare function downloadBlob(presignedUrl: string): Promise<Buffer>;
+//# sourceMappingURL=repo-api.d.ts.map

package/dist/src/lib/repo-api.d.ts.map

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

package/dist/src/lib/repo-api.js

@@ -0,0 +1,75 @@
+// submodules/butterbase-oss/packages/cli/src/lib/repo-api.ts
+import { apiGet, apiPost, apiDelete } from './api-client.js';
+export const repoApi = {
+    prepare(appId, body) {
+        return apiPost(`/v1/${appId}/repo/snapshots/prepare`, body);
+    },
+    commit(appId, manifest) {
+        return apiPost(`/v1/${appId}/repo/snapshots/commit`, { manifest });
+    },
+    getLatest(appId) {
+        return apiGet(`/v1/${appId}/repo/snapshots/latest`);
+    },
+    getSnapshot(appId, snapshotId) {
+        return apiGet(`/v1/${appId}/repo/snapshots/${snapshotId}`);
+    },
+    listSnapshots(appId) {
+        return apiGet(`/v1/${appId}/repo/snapshots`);
+    },
+    getBlobUrl(appId, sha256) {
+        return apiGet(`/v1/${appId}/repo/blobs/${sha256}`);
+    },
+    batchBlobUrls(appId, shas) {
+        return apiPost(`/v1/${appId}/repo/blobs/batch`, { shas });
+    },
+    wipe(appId) {
+        return apiDelete(`/v1/${appId}/repo`);
+    },
+};
+export const cloneApi = {
+    create(sourceAppId, body) {
+        return apiPost(`/v1/templates/${sourceAppId}/clone`, body);
+    },
+    get(jobId) {
+        return apiGet(`/v1/clone-jobs/${jobId}`);
+    },
+    retry(jobId) {
+        return apiPost(`/v1/clone-jobs/${jobId}/retry`, {});
+    },
+    listTemplates(opts = {}) {
+        const params = new URLSearchParams();
+        if (opts.q)
+            params.set('q', opts.q);
+        if (opts.sort)
+            params.set('sort', opts.sort);
+        if (opts.region)
+            params.set('region', opts.region);
+        if (opts.limit !== undefined)
+            params.set('limit', String(opts.limit));
+        if (opts.offset !== undefined)
+            params.set('offset', String(opts.offset));
+        const qs = params.toString();
+        return apiGet(`/v1/templates${qs ? `?${qs}` : ''}`);
+    },
+};
+/** Raw PUT to a presigned S3 URL. No auth header — URL is signed. */
+export async function uploadBlob(presignedUrl, body) {
+    const res = await fetch(presignedUrl, {
+        method: 'PUT',
+        body: new Uint8Array(body),
+        headers: { 'content-type': 'application/octet-stream' },
+    });
+    if (!res.ok) {
+        const txt = await res.text().catch(() => '');
+        throw new Error(`Presigned PUT failed (${res.status}): ${txt.slice(0, 300)}`);
+    }
+}
+/** Fetch a blob via the presigned GET URL returned by getBlobUrl. */
+export async function downloadBlob(presignedUrl) {
+    const res = await fetch(presignedUrl);
+    if (!res.ok)
+        throw new Error(`Presigned GET failed (${res.status})`);
+    const ab = await res.arrayBuffer();
+    return Buffer.from(ab);
+}
+//# sourceMappingURL=repo-api.js.map

package/dist/src/lib/repo-api.js.map

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

package/dist/src/lib/repo-ignore.d.ts

@@ -0,0 +1,17 @@
+import { type Ignore } from 'ignore';
+/** Hardcoded defaults that always apply unless explicitly un-ignored in .butterbaseignore. */
+export declare const HARDCODED_IGNORES: string[];
+/**
+ * Load ignore rules from `root`.
+ *
+ * Precedence (highest wins): .butterbaseignore > .gitignore > HARDCODED_IGNORES.
+ * The `ignore` package treats later add()s as overriding earlier ones, and supports `!path`
+ * negations to un-ignore. So we add in order defaults → .gitignore → .butterbaseignore.
+ */
+export declare function loadIgnoreRules(root: string): Promise<Ignore>;
+/**
+ * Test whether a posix-style relative path is ignored.
+ * Pass directory paths with a trailing slash, e.g. `foo/`.
+ */
+export declare function isIgnored(ig: Ignore, posixRelPath: string): boolean;
+//# sourceMappingURL=repo-ignore.d.ts.map

package/dist/src/lib/repo-ignore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-ignore.d.ts","sourceRoot":"","sources":["../../../src/lib/repo-ignore.ts"],"names":[],"mappings":"AAGA,OAAe,EAAE,KAAK,MAAM,EAAE,MAAM,QAAQ,CAAC;AAE7C,8FAA8F;AAC9F,eAAO,MAAM,iBAAiB,UAS7B,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAenE;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAGnE"}

package/dist/src/lib/repo-ignore.js

@@ -0,0 +1,44 @@
+// submodules/butterbase-oss/packages/cli/src/lib/repo-ignore.ts
+import fs from 'fs-extra';
+import path from 'path';
+import ignore from 'ignore';
+/** Hardcoded defaults that always apply unless explicitly un-ignored in .butterbaseignore. */
+export const HARDCODED_IGNORES = [
+    '.git/',
+    'node_modules/',
+    'dist/',
+    '.next/',
+    '.turbo/',
+    '.DS_Store',
+    // The bound-app config and its caches.
+    '.butterbase/',
+];
+/**
+ * Load ignore rules from `root`.
+ *
+ * Precedence (highest wins): .butterbaseignore > .gitignore > HARDCODED_IGNORES.
+ * The `ignore` package treats later add()s as overriding earlier ones, and supports `!path`
+ * negations to un-ignore. So we add in order defaults → .gitignore → .butterbaseignore.
+ */
+export async function loadIgnoreRules(root) {
+    const ig = ignore();
+    ig.add(HARDCODED_IGNORES);
+    const gitIgnore = path.join(root, '.gitignore');
+    if (await fs.pathExists(gitIgnore)) {
+        ig.add(await fs.readFile(gitIgnore, 'utf8'));
+    }
+    const bbIgnore = path.join(root, '.butterbaseignore');
+    if (await fs.pathExists(bbIgnore)) {
+        ig.add(await fs.readFile(bbIgnore, 'utf8'));
+    }
+    return ig;
+}
+/**
+ * Test whether a posix-style relative path is ignored.
+ * Pass directory paths with a trailing slash, e.g. `foo/`.
+ */
+export function isIgnored(ig, posixRelPath) {
+    // ignore() panics on leading "/"; strip it defensively.
+    return ig.ignores(posixRelPath.replace(/^\/+/, ''));
+}
+//# sourceMappingURL=repo-ignore.js.map

package/dist/src/lib/repo-ignore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-ignore.js","sourceRoot":"","sources":["../../../src/lib/repo-ignore.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,MAAuB,MAAM,QAAQ,CAAC;AAE7C,8FAA8F;AAC9F,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,OAAO;IACP,eAAe;IACf,OAAO;IACP,QAAQ;IACR,SAAS;IACT,WAAW;IACX,uCAAuC;IACvC,cAAc;CACf,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY;IAChD,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IACpB,EAAE,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAE1B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAChD,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QACnC,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;IACtD,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClC,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,EAAU,EAAE,YAAoB;IACxD,wDAAwD;IACxD,OAAO,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;AACtD,CAAC"}

package/dist/src/lib/repo-manifest.d.ts

@@ -0,0 +1,12 @@
+import type { FileEntry } from './repo-api.js';
+import type { WalkedFile } from './repo-walk.js';
+/**
+ * Read every file's bytes and compute its sha256. Returns FileEntry[] suitable for
+ * /repo/snapshots/prepare. Caller is responsible for any progress UX — this is a tight loop.
+ *
+ * Concurrency is intentionally serial: a typical repo is small (100 MB cap) and parallel
+ * file reads on cold disk are not necessarily faster. Tighten later if profiling shows
+ * a hot path.
+ */
+export declare function buildManifest(files: WalkedFile[]): Promise<FileEntry[]>;
+//# sourceMappingURL=repo-manifest.d.ts.map

package/dist/src/lib/repo-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-manifest.d.ts","sourceRoot":"","sources":["../../../src/lib/repo-manifest.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAa7E"}

package/dist/src/lib/repo-manifest.js

@@ -0,0 +1,25 @@
+import fs from 'fs-extra';
+import { createHash } from 'crypto';
+/**
+ * Read every file's bytes and compute its sha256. Returns FileEntry[] suitable for
+ * /repo/snapshots/prepare. Caller is responsible for any progress UX — this is a tight loop.
+ *
+ * Concurrency is intentionally serial: a typical repo is small (100 MB cap) and parallel
+ * file reads on cold disk are not necessarily faster. Tighten later if profiling shows
+ * a hot path.
+ */
+export async function buildManifest(files) {
+    const out = [];
+    for (const f of files) {
+        const buf = await fs.readFile(f.absPath);
+        const sha256 = createHash('sha256').update(buf).digest('hex');
+        if (buf.byteLength !== f.size) {
+            // The stat said one thing, the read returned another — likely a concurrent writer.
+            // Surface this rather than committing inconsistent metadata.
+            throw new Error(`File size changed during read: ${f.relPath} (stat=${f.size}, read=${buf.byteLength})`);
+        }
+        out.push({ path: f.relPath, sha256, size: buf.byteLength });
+    }
+    return out;
+}
+//# sourceMappingURL=repo-manifest.js.map

package/dist/src/lib/repo-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-manifest.js","sourceRoot":"","sources":["../../../src/lib/repo-manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAIpC;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAmB;IACrD,MAAM,GAAG,GAAgB,EAAE,CAAC;IAC5B,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC9D,IAAI,GAAG,CAAC,UAAU,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;YAC9B,mFAAmF;YACnF,6DAA6D;YAC7D,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC,OAAO,UAAU,CAAC,CAAC,IAAI,UAAU,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC;QAC1G,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/src/lib/repo-paths.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Mirror of the server's path validation (services/control-api/src/services/repo-manifest.ts).
+ * Keeping it duplicated rather than imported keeps the CLI free of a server import; the rules
+ * are simple enough that drift risk is low (and would surface as a 400 from prepare anyway).
+ */
+export declare const REPO_MAX_PATH_BYTES = 4096;
+export declare class PathError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export declare function validateRelativePath(p: string): void;
+/** Convert a possibly-Windows path (`a\\b`) to forward-slash form for the manifest. */
+export declare function toPosixRelative(rel: string): string;
+//# sourceMappingURL=repo-paths.d.ts.map

package/dist/src/lib/repo-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-paths.d.ts","sourceRoot":"","sources":["../../../src/lib/repo-paths.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAExC,qBAAa,SAAU,SAAQ,KAAK;aACN,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAI1D;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAapD;AAED,uFAAuF;AACvF,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/dist/src/lib/repo-paths.js

@@ -0,0 +1,41 @@
+// submodules/butterbase-oss/packages/cli/src/lib/repo-paths.ts
+/**
+ * Mirror of the server's path validation (services/control-api/src/services/repo-manifest.ts).
+ * Keeping it duplicated rather than imported keeps the CLI free of a server import; the rules
+ * are simple enough that drift risk is low (and would surface as a 400 from prepare anyway).
+ */
+export const REPO_MAX_PATH_BYTES = 4096;
+export class PathError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'PathError';
+    }
+}
+export function validateRelativePath(p) {
+    if (p.length === 0)
+        throw new PathError('repo_path_empty', 'Path is empty');
+    if (Buffer.byteLength(p, 'utf8') > REPO_MAX_PATH_BYTES) {
+        throw new PathError('repo_path_too_long', `Path exceeds ${REPO_MAX_PATH_BYTES} bytes: ${p}`);
+    }
+    if (p.startsWith('/'))
+        throw new PathError('repo_path_absolute', `Path is absolute: ${p}`);
+    if (p.includes('\\'))
+        throw new PathError('repo_path_backslash', `Path contains backslash: ${p}`);
+    if (p.includes('\0'))
+        throw new PathError('repo_path_null_byte', `Path contains null byte`);
+    for (const seg of p.split('/')) {
+        if (seg === '..')
+            throw new PathError('repo_path_traversal', `Path contains '..': ${p}`);
+        if (seg === '.')
+            throw new PathError('repo_path_dot_segment', `Path contains '.' segment: ${p}`);
+        if (seg.length === 0)
+            throw new PathError('repo_path_empty_segment', `Path has empty segment: ${p}`);
+    }
+}
+/** Convert a possibly-Windows path (`a\\b`) to forward-slash form for the manifest. */
+export function toPosixRelative(rel) {
+    return rel.split(/[\\/]+/).join('/');
+}
+//# sourceMappingURL=repo-paths.js.map

package/dist/src/lib/repo-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-paths.js","sourceRoot":"","sources":["../../../src/lib/repo-paths.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAE/D;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAExC,MAAM,OAAO,SAAU,SAAQ,KAAK;IACN;IAA5B,YAA4B,IAAY,EAAE,OAAe;QACvD,KAAK,CAAC,OAAO,CAAC,CAAC;QADW,SAAI,GAAJ,IAAI,CAAQ;QAEtC,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AAED,MAAM,UAAU,oBAAoB,CAAC,CAAS;IAC5C,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,iBAAiB,EAAE,eAAe,CAAC,CAAC;IAC5E,IAAI,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,mBAAmB,EAAE,CAAC;QACvD,MAAM,IAAI,SAAS,CAAC,oBAAoB,EAAE,gBAAgB,mBAAmB,WAAW,CAAC,EAAE,CAAC,CAAC;IAC/F,CAAC;IACD,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,oBAAoB,EAAE,qBAAqB,CAAC,EAAE,CAAC,CAAC;IAC3F,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,qBAAqB,EAAE,4BAA4B,CAAC,EAAE,CAAC,CAAC;IAClG,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,qBAAqB,EAAE,yBAAyB,CAAC,CAAC;IAC5F,KAAK,MAAM,GAAG,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/B,IAAI,GAAG,KAAK,IAAI;YAAE,MAAM,IAAI,SAAS,CAAC,qBAAqB,EAAE,uBAAuB,CAAC,EAAE,CAAC,CAAC;QACzF,IAAI,GAAG,KAAK,GAAG;YAAE,MAAM,IAAI,SAAS,CAAC,uBAAuB,EAAE,8BAA8B,CAAC,EAAE,CAAC,CAAC;QACjG,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,SAAS,CAAC,yBAAyB,EAAE,2BAA2B,CAAC,EAAE,CAAC,CAAC;IACvG,CAAC;AACH,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,OAAO,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACvC,CAAC"}

package/dist/src/lib/repo-walk.d.ts

@@ -0,0 +1,14 @@
+import type { Ignore } from 'ignore';
+export interface WalkedFile {
+    /** Posix-style relative path from `root`. */
+    relPath: string;
+    /** Absolute filesystem path. */
+    absPath: string;
+    size: number;
+}
+/**
+ * Async-iterate every non-ignored regular file under `root`.
+ * Skips symlinks. Validates each path through validateRelativePath; throws on bad ones.
+ */
+export declare function walkRepo(root: string, ig: Ignore): AsyncGenerator<WalkedFile>;
+//# sourceMappingURL=repo-walk.d.ts.map

package/dist/src/lib/repo-walk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-walk.d.ts","sourceRoot":"","sources":["../../../src/lib/repo-walk.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGrC,MAAM,WAAW,UAAU;IACzB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAuB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,cAAc,CAAC,UAAU,CAAC,CAuBpF"}

package/dist/src/lib/repo-walk.js

@@ -0,0 +1,36 @@
+import fs from 'fs-extra';
+import path from 'path';
+import { isIgnored } from './repo-ignore.js';
+import { toPosixRelative, validateRelativePath } from './repo-paths.js';
+/**
+ * Async-iterate every non-ignored regular file under `root`.
+ * Skips symlinks. Validates each path through validateRelativePath; throws on bad ones.
+ */
+export async function* walkRepo(root, ig) {
+    async function* recurse(dir) {
+        const entries = await fs.readdir(dir, { withFileTypes: true });
+        // Sorted for determinism (stable progress reporting, stable manifests in tests).
+        entries.sort((a, b) => a.name.localeCompare(b.name));
+        for (const entry of entries) {
+            const abs = path.join(dir, entry.name);
+            const rel = toPosixRelative(path.relative(root, abs));
+            // For directory ignore checks the `ignore` package expects a trailing slash.
+            const probe = entry.isDirectory() ? `${rel}/` : rel;
+            if (isIgnored(ig, probe))
+                continue;
+            if (entry.isSymbolicLink())
+                continue; // Skip symlinks — content semantics are ambiguous.
+            if (entry.isDirectory()) {
+                yield* recurse(abs);
+                continue;
+            }
+            if (!entry.isFile())
+                continue; // sockets, fifos, etc.
+            validateRelativePath(rel);
+            const st = await fs.stat(abs);
+            yield { relPath: rel, absPath: abs, size: st.size };
+        }
+    }
+    yield* recurse(root);
+}
+//# sourceMappingURL=repo-walk.js.map

package/dist/src/lib/repo-walk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-walk.js","sourceRoot":"","sources":["../../../src/lib/repo-walk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAUxE;;;GAGG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,QAAQ,CAAC,IAAY,EAAE,EAAU;IACtD,KAAK,SAAS,CAAC,CAAC,OAAO,CAAC,GAAW;QACjC,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/D,iFAAiF;QACjF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACrD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACvC,MAAM,GAAG,GAAG,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;YACtD,6EAA6E;YAC7E,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;YACpD,IAAI,SAAS,CAAC,EAAE,EAAE,KAAK,CAAC;gBAAE,SAAS;YACnC,IAAI,KAAK,CAAC,cAAc,EAAE;gBAAE,SAAS,CAAE,mDAAmD;YAC1F,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,KAAK,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBACpB,SAAS;YACX,CAAC;YACD,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;gBAAE,SAAS,CAAE,uBAAuB;YACvD,oBAAoB,CAAC,GAAG,CAAC,CAAC;YAC1B,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC9B,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;QACtD,CAAC;IACH,CAAC;IACD,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACvB,CAAC"}