@goliapkg/sentori-cli 1.4.1 → 1.6.0

package/lib/srcbundle.js

@@ -1,69 +1,192 @@
-// `sentori-cli upload srcbundle` — native source context without
-// repository access.
-//
-// Walks the given directories for native source files, packs them
-// as one JSON object (project-relative path → content), and lands
-// it on the artifacts endpoint as kind `srcbundle`. The server
-// reads it when a dSYM/proguard frame resolves to file+line, so
-// the dashboard shows the failing native code the same way a
-// sourcemap's embedded sourcesContent covers JS. The build owns
-// exactly what goes in — nothing is pulled from git, ever.
-import { readFileSync, readdirSync, statSync } from 'node:fs';
-import { join, relative } from 'node:path';
-/** Native + shared-code extensions worth carrying. JS/TS ride the
- *  sourcemap already; including them anyway is harmless but bulky,
- *  so they stay out by default. */
-const SOURCE_EXTS = new Set(['.swift', '.kt', '.kts', '.java', '.m', '.mm', '.h', '.c', '.cc', '.cpp', '.hpp']);
-const SKIP_DIRS = new Set(['node_modules', '.git', 'build', 'Pods', 'DerivedData', '.gradle', 'dist']);
-/** A single source file larger than this is generated, not written. */
-const MAX_FILE_BYTES = 512 * 1024;
-/** Total budget before compression; the wire is gzip anyway. */
-const MAX_TOTAL_BYTES = 64 * 1024 * 1024;
-/** Collect `{ relPath: content }` from the roots. */
-export function collectSources(roots) {
-    const bundle = {};
+// Source archives are build artifacts. Directory mode needs no repository;
+// tag mode reads immutable Git objects without changing the working tree.
+import { execFileSync } from 'node:child_process';
+import { createHash } from 'node:crypto';
+import { lstatSync, readFileSync, readdirSync, realpathSync } from 'node:fs';
+import { extname, isAbsolute, relative, resolve, sep } from 'node:path';
+import { unzipSync, zipSync } from 'fflate';
+export const SOURCE_MANIFEST = 'sentori-source-manifest.json';
+export const MAX_SOURCE_FILE_BYTES = 512 * 1024;
+export const MAX_SOURCE_BYTES = 64 * 1024 * 1024;
+const MAX_FILES = 10000;
+const SOURCE_EXTS = new Set(['.swift', '.kt', '.kts', '.java', '.m', '.mm', '.h', '.c', '.cc', '.cpp', '.hpp', '.js', '.jsx', '.ts', '.tsx', '.vue', '.svelte', '.rs', '.go', '.py', '.rb', '.php', '.cs', '.dart']);
+const SKIP_DIRS = new Set(['node_modules', 'build', 'Pods', 'DerivedData', 'dist', 'target', 'vendor', '__pycache__']);
+const sha256 = (bytes) => createHash('sha256').update(bytes).digest('hex');
+export function safeSourcePath(path) {
+    return path.length > 0 && path.length <= 1024 && !/[\\\x00-\x1f:]/.test(path)
+        && !path.startsWith('/') && path.split('/').every(part => part !== '' && part !== '.' && part !== '..');
+}
+function selected(path, includes, excludes) {
+    const under = (parent) => parent === '.' || path === parent || path.startsWith(`${parent}/`);
+    return includes.some(under) && !excludes.some(under);
+}
+function sourcePath(path, includes) {
+    return safeSourcePath(path) && SOURCE_EXTS.has(extname(path).toLowerCase())
+        && !path.split('/').some((part, index, parts) => part.startsWith('.') || SKIP_DIRS.has(part)
+            && !includes.some(include => include === parts.slice(0, index + 1).join('/') || include.startsWith(parts.slice(0, index + 1).join('/') + '/')));
+}
+function readText(bytes, path) {
+    if (bytes.includes(0))
+        throw new Error(`source is not UTF-8 text: ${path}`);
+    try {
+        return new TextDecoder('utf-8', { fatal: true }).decode(bytes);
+    }
+    catch {
+        throw new Error(`source is not UTF-8 text: ${path}`);
+    }
+}
+function selectionPath(root, path) {
+    const rel = relative(root, resolve(root, path)).split(sep).join('/') || '.';
+    if (rel !== '.' && !safeSourcePath(rel))
+        throw new Error(`source path is outside --root: ${path}`);
+    return rel;
+}
+/** Keep every path relative to ONE root, even with several selected directories. */
+export function collectSources(paths, options = {}) {
+    if (!paths.length)
+        throw new Error('choose source directories or files (for example: ios android/app/src shared)');
+    const root = realpathSync(resolve(options.root ?? '.'));
+    const includes = paths.map(path => selectionPath(root, path));
+    const excludes = (options.exclude ?? []).map(path => selectionPath(root, path));
+    const bundle = Object.create(null);
     const stats = { files: 0, bytes: 0, skipped: 0 };
-    const walk = (root, dir) => {
-        let entries;
-        try {
-            entries = readdirSync(dir, { withFileTypes: true });
-        }
-        catch {
+    const add = (path, bytes) => {
+        if (Object.hasOwn(bundle, path))
             return;
-        }
-        for (const e of entries) {
-            if (e.isDirectory()) {
-                if (!SKIP_DIRS.has(e.name) && !e.name.startsWith('.'))
-                    walk(root, join(dir, e.name));
-                continue;
-            }
-            const dot = e.name.lastIndexOf('.');
-            if (dot < 0 || !SOURCE_EXTS.has(e.name.slice(dot)))
+        if (bytes.length > MAX_SOURCE_FILE_BYTES)
+            throw new Error(`source exceeds 512 KiB: ${path}; explicitly exclude it if not needed`);
+        if (stats.bytes + bytes.length > MAX_SOURCE_BYTES || stats.files >= MAX_FILES)
+            throw new Error('source bundle exceeds 64 MiB or 10000 files; narrow the selected directories');
+        bundle[path] = readText(bytes, path);
+        stats.files++;
+        stats.bytes += bytes.length;
+    };
+    let source = { type: 'directory' };
+    if (options.gitTag) {
+        const git = (args, limit = MAX_SOURCE_BYTES) => execFileSync('git', ['-C', root, ...args], { maxBuffer: limit, stdio: ['ignore', 'pipe', 'pipe'] });
+        const top = realpathSync(git(['rev-parse', '--show-toplevel']).toString().trim());
+        if (root !== top)
+            throw new Error('--root must be the repository root when using --git-tag');
+        const tag = options.gitTag;
+        git(['check-ref-format', `refs/tags/${tag}`]);
+        const commit = git(['rev-parse', '--verify', `refs/tags/${tag}^{commit}`]).toString().trim();
+        if (!/^[0-9a-f]{40,64}$/.test(commit))
+            throw new Error('tag did not resolve to a commit');
+        source = { type: 'git-tag', tag, commit };
+        const records = git(['ls-tree', '-rlz', '--full-tree', commit]).toString().split('\0').filter(Boolean);
+        const matched = new Set();
+        for (const record of records) {
+            const tab = record.indexOf('\t');
+            const path = record.slice(tab + 1);
+            if (!selected(path, includes, excludes) || !sourcePath(path, includes))
                 continue;
-            const full = join(dir, e.name);
-            let size;
-            try {
-                size = statSync(full).size;
-            }
-            catch {
+            const [mode, type, oid, size] = record.slice(0, tab).trim().split(/\s+/);
+            if (type !== 'blob' || !['100644', '100755'].includes(mode)) {
+                stats.skipped++;
                 continue;
             }
-            if (size > MAX_FILE_BYTES || stats.bytes + size > MAX_TOTAL_BYTES) {
-                stats.skipped += 1;
-                continue;
+            if (Number(size) > MAX_SOURCE_FILE_BYTES)
+                throw new Error(`source exceeds 512 KiB: ${path}`);
+            for (const item of includes)
+                if (selected(path, [item], []))
+                    matched.add(item);
+            add(path, git(['cat-file', 'blob', oid], MAX_SOURCE_FILE_BYTES + 1));
+        }
+        for (const item of includes)
+            if (!matched.has(item))
+                throw new Error(`no source files at tag ${tag} under ${item}`);
+    }
+    else {
+        const walk = (path) => {
+            const full = resolve(root, path);
+            const stat = lstatSync(full);
+            if (stat.isSymbolicLink()) {
+                stats.skipped++;
+                return;
             }
-            try {
-                bundle[relative(root, full)] = readFileSync(full, 'utf8');
-                stats.files += 1;
-                stats.bytes += size;
+            const real = relative(root, realpathSync(full));
+            if (real.startsWith(`..${sep}`) || real === '..' || isAbsolute(real))
+                throw new Error(`source resolves outside --root: ${path}`);
+            if (stat.isDirectory()) {
+                for (const entry of readdirSync(full).sort()) {
+                    if (entry.startsWith('.') || SKIP_DIRS.has(entry)) {
+                        stats.skipped++;
+                        continue;
+                    }
+                    const child = path === '.' ? entry : `${path}/${entry}`;
+                    if (excludes.some(x => child === x || child.startsWith(`${x}/`)))
+                        continue;
+                    walk(child);
+                }
             }
-            catch {
-                stats.skipped += 1;
+            else if (stat.isFile() && sourcePath(path, includes) && selected(path, includes, excludes)) {
+                if (stat.size > MAX_SOURCE_FILE_BYTES)
+                    throw new Error(`source exceeds 512 KiB: ${path}`);
+                add(path, readFileSync(full));
             }
+        };
+        for (const path of includes)
+            walk(path);
+    }
+    if (!stats.files)
+        throw new Error('no supported source files selected; choose the application source directories');
+    return { bundle, stats, source };
+}
+export function packSources(paths, release, options = {}) {
+    if (!release.trim())
+        throw new Error('release is required and must match the SDK release');
+    const { bundle, stats, source } = collectSources(paths, options);
+    const entries = Object.create(null);
+    const manifest = { version: 1, release, source, files: [] };
+    for (const path of Object.keys(bundle).sort()) {
+        const bytes = Buffer.from(bundle[path], 'utf8');
+        entries[path] = bytes;
+        manifest.files.push({ path, bytes: bytes.length, sha256: sha256(bytes) });
+    }
+    entries[SOURCE_MANIFEST] = Buffer.from(JSON.stringify(manifest, null, 2) + '\n');
+    return { bytes: zipSync(entries, { level: 6, mtime: new Date(2000, 0, 1) }), manifest, stats };
+}
+/** Validate in memory; the server independently repeats validation. */
+export function inspectSourceArchive(bytes, release) {
+    if (bytes.length > MAX_SOURCE_BYTES + 4 * 1024 * 1024)
+        throw new Error('source archive is too large');
+    const names = new Set();
+    let total = 0;
+    const files = unzipSync(bytes, { filter: file => {
+            const path = file.name.replace(/\/$/, '');
+            if (!safeSourcePath(path) || names.has(path))
+                throw new Error(`unsafe or duplicate ZIP path: ${file.name}`);
+            names.add(path);
+            if (names.size > MAX_FILES + 1)
+                throw new Error('ZIP contains too many entries');
+            const limit = path === SOURCE_MANIFEST ? 4 * 1024 * 1024 : MAX_SOURCE_FILE_BYTES;
+            total += file.originalSize;
+            if (file.originalSize > limit || total > MAX_SOURCE_BYTES + 4 * 1024 * 1024)
+                throw new Error('ZIP exceeds source size limits');
+            return !file.name.endsWith('/');
+        } });
+    const sources = Object.keys(files).filter(path => path !== SOURCE_MANIFEST);
+    if (!sources.length)
+        throw new Error('source ZIP is empty');
+    for (const path of sources)
+        readText(files[path], path);
+    let manifest;
+    if (files[SOURCE_MANIFEST]) {
+        manifest = JSON.parse(readText(files[SOURCE_MANIFEST], SOURCE_MANIFEST));
+        if (!manifest || manifest.version !== 1 || typeof manifest.release !== 'string' || !manifest.release.trim() || !Array.isArray(manifest.files)
+            || !manifest.source || !['directory', 'git-tag'].includes(manifest.source.type)
+            || manifest.files.some(file => !file || typeof file.path !== 'string'))
+            throw new Error('invalid source manifest');
+        if (release && manifest.release !== release)
+            throw new Error(`ZIP release ${manifest.release} does not match ${release}`);
+        if (manifest.files.length !== sources.length || new Set(manifest.files.map(file => file.path)).size !== sources.length)
+            throw new Error('source manifest file list does not match ZIP');
+        for (const file of manifest.files) {
+            const body = files[file.path];
+            if (!body || body.length !== file.bytes || sha256(body) !== file.sha256)
+                throw new Error(`source manifest checksum mismatch: ${file.path}`);
         }
-    };
-    for (const root of roots)
-        walk(root, root);
-    return { bundle, stats };
+    }
+    return { files: sources.sort(), manifest };
 }
 //# sourceMappingURL=srcbundle.js.map

package/lib/srcbundle.js.map

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

package/lib/upload.d.ts

@@ -19,7 +19,52 @@ export declare function gzipForWire(bytes: Buffer | Uint8Array, name: string): {
  *  be 16 KB of pool (offset view) — a Blob built on it would ship
  *  garbage bytes around the payload. */
 export declare function wireArrayBuffer(wire: Uint8Array): ArrayBuffer;
-export declare function uploadArtifact(opts: UploadOpts): Promise<{
+/** What the server said about the file it just stored.
+ *
+ *  `usable: false` means it landed and will symbolicate nothing —
+ *  a Hermes bundle passed off as a source map, a zip where a Mach-O
+ *  was expected. The server has answered this since 2.15.0 and its
+ *  own comment says "the response says so"; nothing read it, so the
+ *  first anyone heard was a release page months later with the file
+ *  sitting under a green light.
+ *
+ *  Warned, never thrown. An artifact upload may not fail a
+ *  customer's build — see the zero-cost rule — and this one did
+ *  store. `--strict` is where a caller opts into a hard stop.
+ */
+export type UploadVerdict = {
     id: string;
-}>;
+    /** `null` for kinds the server does not parse ahead of time. */
+    usable?: boolean | null;
+    /** What to upload instead. Present only when `usable === false`. */
+    hint?: null | string;
+};
+/** Say it once, at the only place every upload passes through. */
+export declare function warnIfUnusable(name: string, v: UploadVerdict): boolean;
+/**
+ * Turn one path into the source maps under it, each with the name the
+ * server should store.
+ *
+ * A file keeps its basename. A **directory** is walked, and every map
+ * under it keeps its path *relative to that directory* — so
+ * `dist/pages/cart/index.js.map` is stored as
+ * `pages/cart/index.js.map` and not as `index.js.map`.
+ *
+ * That difference is the whole feature. The server matches a frame to
+ * a map by how many trailing path segments they share, precisely
+ * because a WeChat mini program names every page's entry `index.js`
+ * and a web build names every route chunk after its route. Sending
+ * only the basename threw that away on the client, so the matching
+ * could never see more than a filename however carefully it was
+ * written.
+ *
+ * Passing a directory used to read the directory as a file and throw
+ * `EISDIR`, while `docs/getting-started/web.md` told readers to pass
+ * `./dist`.
+ */
+export declare function expandSourcemapPaths(path: string): {
+    path: string;
+    name: string;
+}[];
+export declare function uploadArtifact(opts: UploadOpts): Promise<UploadVerdict>;
 //# sourceMappingURL=upload.d.ts.map

package/lib/upload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../src/upload.ts"],"names":[],"mappings":"AAmBA,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,CAAA;IACrD,IAAI,EAAE,MAAM,CAAA;IACZ,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAMD;;8DAE8D;AAC9D,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,GAAG,UAAU,EAC1B,IAAI,EAAE,MAAM,GACX;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAWxC;AAED;;;wCAGwC;AACxC,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW,CAE7D;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,CAoC9E"}
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../src/upload.ts"],"names":[],"mappings":"AAoBA,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,CAAA;IACrD,IAAI,EAAE,MAAM,CAAA;IACZ,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAMD;;8DAE8D;AAC9D,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,GAAG,UAAU,EAC1B,IAAI,EAAE,MAAM,GACX;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAWxC;AAED;;;wCAGwC;AACxC,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW,CAE7D;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,gEAAgE;IAChE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IACvB,oEAAoE;IACpE,IAAI,CAAC,EAAE,IAAI,GAAG,MAAM,CAAA;CACrB,CAAA;AAED,kEAAkE;AAClE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,aAAa,GAAG,OAAO,CAStE;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CA0BnF;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,CAsC7E"}

package/lib/upload.js

@@ -13,7 +13,8 @@
 // smaller than its decompressed cap precisely so that the big ones
 // (a real RN app's main dSYM runs hundreds of MB) fit as gzip.
 import { readFileSync } from 'node:fs';
-import { basename } from 'node:path';
+import { readdirSync, statSync } from 'node:fs';
+import { basename, join, relative, sep } from 'node:path';
 import { gzipSync } from 'node:zlib';
 /** Transport-side limit on the current server (256 MB). Used only to
  *  produce a useful error message — the server is the authority. */
@@ -38,6 +39,66 @@ export function gzipForWire(bytes, name) {
 export function wireArrayBuffer(wire) {
     return wire.buffer.slice(wire.byteOffset, wire.byteOffset + wire.byteLength);
 }
+/** Say it once, at the only place every upload passes through. */
+export function warnIfUnusable(name, v) {
+    if (v.usable !== false)
+        return false;
+    // `warn`, not `error`: red text makes a host team believe their
+    // build broke, and this one did not.
+    console.warn(`[sentori-cli] ${name} stored, but the server cannot read it — ` +
+        `it will symbolicate nothing.${v.hint ? ` ${v.hint}` : ''}`);
+    return true;
+}
+/**
+ * Turn one path into the source maps under it, each with the name the
+ * server should store.
+ *
+ * A file keeps its basename. A **directory** is walked, and every map
+ * under it keeps its path *relative to that directory* — so
+ * `dist/pages/cart/index.js.map` is stored as
+ * `pages/cart/index.js.map` and not as `index.js.map`.
+ *
+ * That difference is the whole feature. The server matches a frame to
+ * a map by how many trailing path segments they share, precisely
+ * because a WeChat mini program names every page's entry `index.js`
+ * and a web build names every route chunk after its route. Sending
+ * only the basename threw that away on the client, so the matching
+ * could never see more than a filename however carefully it was
+ * written.
+ *
+ * Passing a directory used to read the directory as a file and throw
+ * `EISDIR`, while `docs/getting-started/web.md` told readers to pass
+ * `./dist`.
+ */
+export function expandSourcemapPaths(path) {
+    let stat;
+    try {
+        stat = statSync(path);
+    }
+    catch {
+        // Let the caller's read produce the real error, with the real
+        // path in it.
+        return [{ path, name: basename(path) }];
+    }
+    if (!stat.isDirectory())
+        return [{ path, name: basename(path) }];
+    const out = [];
+    const walk = (dir) => {
+        for (const e of readdirSync(dir, { withFileTypes: true })) {
+            const full = join(dir, e.name);
+            if (e.isDirectory())
+                walk(full);
+            else if (e.name.endsWith('.map') || e.name.endsWith('.map.gz')) {
+                // POSIX separators on the wire whatever the build machine is:
+                // the server compares these against a frame's `file`, which is
+                // a URL or a module path, and neither uses a backslash.
+                out.push({ path: full, name: relative(path, full).split(sep).join('/') });
+            }
+        }
+    };
+    walk(path);
+    return out;
+}
 export async function uploadArtifact(opts) {
     const bytes = readFileSync(opts.path);
     if (bytes.length === 0)
@@ -70,6 +131,8 @@ export async function uploadArtifact(opts) {
         const detail = await resp.text().catch(() => '');
         throw new Error(`${resp.status} ${resp.statusText}${detail ? ` — ${detail.slice(0, 200)}` : ''}`);
     }
-    return (await resp.json());
+    const verdict = (await resp.json());
+    warnIfUnusable(opts.name ?? basename(opts.path), verdict);
+    return verdict;
 }
 //# sourceMappingURL=upload.js.map

package/lib/upload.js.map

@@ -1 +1 @@
-{"version":3,"file":"upload.js","sourceRoot":"","sources":["../src/upload.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,iEAAiE;AACjE,kEAAkE;AAClE,8DAA8D;AAC9D,qEAAqE;AACrE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,2DAA2D;AAC3D,kEAAkE;AAClE,mEAAmE;AACnE,mEAAmE;AACnE,+DAA+D;AAE/D,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAYpC;oEACoE;AACpE,MAAM,UAAU,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAA;AAEpC;;8DAE8D;AAC9D,MAAM,UAAU,WAAW,CACzB,KAA0B,EAC1B,IAAY;IAEZ,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,CAAA;IAC7E,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAA;IAChF,MAAM,QAAQ,GAAG,SAAS,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,CAAA;IACxE,IAAI,IAAI,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CACb,GAAG,IAAI,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC,gBAAgB;YACjE,qBAAqB,UAAU,GAAG,IAAI,GAAG,IAAI,qCAAqC,CACrF,CAAA;IACH,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAA;AAC3B,CAAC;AAED;;;wCAGwC;AACxC,MAAM,UAAU,eAAe,CAAC,IAAgB;IAC9C,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAgB,CAAA;AAC7F,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAgB;IACnD,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACrC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;IAEnE,+DAA+D;IAC/D,qEAAqE;IACrE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;IAE/E,MAAM,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAA;IAC3B,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAA;IAC9B,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAA;IAEhE,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,gBAAgB,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAA;IAC1G,IAAI,IAAc,CAAA;IAClB,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YACtB,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,IAAI,CAAC,KAAK,EAAE,EAAE;YAClD,IAAI,EAAE,IAAI;SACX,CAAC,CAAA;IACJ,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,yDAAyD;QACzD,iEAAiE;QACjE,kEAAkE;QAClE,kDAAkD;QAClD,MAAM,IAAI,KAAK,CACb,kBAAkB,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;YAChE,mEAAmE;YACnE,eAAe,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC,kBAAkB,CACzE,CAAA;IACH,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAA;QAChD,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IACnG,CAAC;IACD,OAAO,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAmB,CAAA;AAC9C,CAAC"}
+{"version":3,"file":"upload.js","sourceRoot":"","sources":["../src/upload.ts"],"names":[],"mappings":"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"}

package/lib/workflow.d.ts

@@ -0,0 +1,47 @@
+import { type UploadOpts } from './upload.js';
+export type UploadConfig = {
+    version: 1;
+    apiUrl: string;
+    tokenEnv: string;
+    release?: string;
+    artifacts: {
+        sourcemap?: string[];
+        dsym?: string[];
+        mapping?: string[];
+    };
+    sources?: {
+        root?: string;
+        include: string[];
+        exclude?: string[];
+        gitTag?: string;
+    };
+    sourceArchive?: string;
+};
+export type UploadPlan = {
+    release: string;
+    apiUrl: string;
+    tokenEnv: string;
+    files: {
+        kind: UploadOpts['kind'];
+        name: string;
+        path: string;
+        hash: string;
+        bytes: number;
+    }[];
+    source?: {
+        files: string[];
+        tag?: string;
+        commit?: string;
+    };
+};
+export declare const WORKFLOW_HELP = "Release uploads:\n  sentori init --api-url <url> [--release <r>] [--sourcemap <path>] [--dsym <path>]\n               [--mapping <path>] [--sources <dir>] [--git-tag <tag>] [--config <file>]\n  sentori config validate [--config sentori.config.json] [--release <r>]\n  sentori doctor [--config sentori.config.json] [--api-url <url>]\n  sentori upload all [--config sentori.config.json] [--release <r>] [--git-tag <tag>]\n                    [--dry-run] [--strict]\n  sentori verify [--config sentori.config.json] [--release <r>] [--git-tag <tag>]\n  sentori sources pack --release <r> --output sources.zip [--root .] [--git-tag <tag>]\n                       [--exclude <path>] <source-dir-or-file...>\n  sentori upload srcbundle --release <r> [--root .] [--git-tag <tag>] <sources.zip|source-dir...>\n\nPaths in config are relative to that config. Sources keep paths relative to sources.root.\nSet the API-scope token in SENTORI_TOKEN (or the configured tokenEnv); init never stores it.\nRelease must match the SDK exactly, including its build number. SENTORI_RELEASE is supported.\nGit mode reads the specified tag's commit, never the working tree or a guessed latest tag.\nVerification checks every planned file's bytes and server validation; it does not claim event matching.\n";
+export declare function loadUploadConfig(path: string): UploadConfig;
+export declare function prepareUploadPlan(configPath: string, overrides?: {
+    release?: string;
+    apiUrl?: string;
+    gitTag?: string;
+}): UploadPlan;
+export declare function verifyUploadPlan(plan: UploadPlan, token: string): Promise<string[]>;
+export declare function runWorkflow(command: 'init' | 'validate' | 'upload' | 'verify' | 'doctor', argv: string[]): Promise<number>;
+export declare function runSourcesPack(argv: string[]): Promise<number>;
+//# sourceMappingURL=workflow.d.ts.map

package/lib/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../src/workflow.ts"],"names":[],"mappings":"AASA,OAAO,EAAwC,KAAK,UAAU,EAAE,MAAM,aAAa,CAAA;AAGnF,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,CAAC,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAA;IACxE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACnF,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA;AACD,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE;QAAE,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAC9F,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAC5D,CAAA;AAMD,eAAO,MAAM,aAAa,qwCAiBzB,CAAA;AAMD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAuB3D;AAeD,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,UAAU,CAkDxI;AACD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAWzF;AACD,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAkEhI;AACD,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAepE"}