@alwaysmeticulous/cli 2.279.0 → 2.280.0

package/dist/commands/project/index.js

@@ -1,16 +1,17 @@
 "use strict";
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="be4c1da8-74d9-5650-845c-0adc017abafe")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="55f684ba-706c-5f96-aff2-b198119381aa")}catch(e){}}();
 
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.projectCommand = void 0;
 const show_command_1 = require("./show.command");
+const upload_source_command_1 = require("./upload-source.command");
 exports.projectCommand = {
     command: "project",
     describe: "Project commands",
-    builder: (yargs) => yargs.command(show_command_1.showCommand).demandCommand().help(),
+    builder: (yargs) => yargs.command(show_command_1.showCommand).command(upload_source_command_1.uploadSourceCommand).demandCommand().help(),
     handler: () => {
         // subcommand handles this
     },
 };
 //# sourceMappingURL=index.js.map
-//# debugId=be4c1da8-74d9-5650-845c-0adc017abafe
+//# debugId=55f684ba-706c-5f96-aff2-b198119381aa

package/dist/commands/project/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../src/commands/project/index.ts"],"sourceRoot":"","names":[],"mappings":";;;;;AACA,iDAA6C;AAEhC,QAAA,cAAc,GAAkB;IAC3C,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,kBAAkB;IAC5B,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,0BAAW,CAAC,CAAC,aAAa,EAAE,CAAC,IAAI,EAAE;IACrE,OAAO,EAAE,GAAG,EAAE;QACZ,0BAA0B;IAC5B,CAAC;CACF,CAAC","debugId":"be4c1da8-74d9-5650-845c-0adc017abafe"}
+{"version":3,"file":"index.js","sources":["../../../src/commands/project/index.ts"],"sourceRoot":"","names":[],"mappings":";;;;;AACA,iDAA6C;AAC7C,mEAA8D;AAEjD,QAAA,cAAc,GAAkB;IAC3C,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,kBAAkB;IAC5B,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CACjB,KAAK,CAAC,OAAO,CAAC,0BAAW,CAAC,CAAC,OAAO,CAAC,2CAAmB,CAAC,CAAC,aAAa,EAAE,CAAC,IAAI,EAAE;IAChF,OAAO,EAAE,GAAG,EAAE;QACZ,0BAA0B;IAC5B,CAAC;CACF,CAAC","debugId":"55f684ba-706c-5f96-aff2-b198119381aa"}

package/dist/commands/project/upload-source.command.d.ts

@@ -0,0 +1,31 @@
+import { CommandModule } from "yargs";
+interface Options {
+    apiToken?: string | null | undefined;
+    commitSha: string;
+    sourceDir: string;
+}
+/**
+ * Packages `--sourceDir` as a `source.tar.gz` archive and uploads it to
+ * Meticulous so it can be used in place of `git clone` for projects that
+ * have source-code uploads enabled.
+ *
+ * The contents of the archive are exactly the contents of `--sourceDir` —
+ * we do not parse `.gitignore` or apply any filtering, so it is the
+ * caller's responsibility to point at a directory that contains only what
+ * Meticulous needs (i.e. exclude `.git/`, `node_modules/`, `dist/`, build
+ * artefacts, secrets, etc.). The recommended pattern is to invoke this
+ * after a fresh `git checkout` into a clean directory, or after a
+ * `git archive`/`rsync --exclude` step in CI.
+ *
+ * Usage (typically from the customer's CI on every commit):
+ *
+ *   meticulous project upload-source \
+ *     --commitSha "$(git rev-parse HEAD)" \
+ *     --sourceDir ./checkout
+ *
+ * Requires a project API token (env `METICULOUS_API_TOKEN` or
+ * `--apiToken`). Calls from projects that don't have source-code uploads
+ * enabled are rejected with a 403.
+ */
+export declare const uploadSourceCommand: CommandModule<unknown, Options>;
+export {};

package/dist/commands/project/upload-source.command.js

@@ -0,0 +1,109 @@
+"use strict";
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="80bf9498-6e60-5fd3-8e7a-5798f20c3eed")}catch(e){}}();
+
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uploadSourceCommand = void 0;
+const fs_1 = require("fs");
+const promises_1 = require("fs/promises");
+const os_1 = require("os");
+const path_1 = require("path");
+const promises_2 = require("stream/promises");
+const client_1 = require("@alwaysmeticulous/client");
+const common_1 = require("@alwaysmeticulous/common");
+const tar_1 = require("tar");
+const sentry_utils_1 = require("../../command-utils/sentry.utils");
+/**
+ * Packages `--sourceDir` as a `source.tar.gz` archive and uploads it to
+ * Meticulous so it can be used in place of `git clone` for projects that
+ * have source-code uploads enabled.
+ *
+ * The contents of the archive are exactly the contents of `--sourceDir` —
+ * we do not parse `.gitignore` or apply any filtering, so it is the
+ * caller's responsibility to point at a directory that contains only what
+ * Meticulous needs (i.e. exclude `.git/`, `node_modules/`, `dist/`, build
+ * artefacts, secrets, etc.). The recommended pattern is to invoke this
+ * after a fresh `git checkout` into a clean directory, or after a
+ * `git archive`/`rsync --exclude` step in CI.
+ *
+ * Usage (typically from the customer's CI on every commit):
+ *
+ *   meticulous project upload-source \
+ *     --commitSha "$(git rev-parse HEAD)" \
+ *     --sourceDir ./checkout
+ *
+ * Requires a project API token (env `METICULOUS_API_TOKEN` or
+ * `--apiToken`). Calls from projects that don't have source-code uploads
+ * enabled are rejected with a 403.
+ */
+exports.uploadSourceCommand = {
+    command: "upload-source",
+    describe: "Upload a source-code archive for a given commit to Meticulous",
+    builder: {
+        apiToken: {
+            string: true,
+            description: "Meticulous project API token. Defaults to METICULOUS_API_TOKEN.",
+        },
+        commitSha: {
+            string: true,
+            demandOption: true,
+            description: "Commit SHA the uploaded archive corresponds to",
+        },
+        sourceDir: {
+            string: true,
+            demandOption: true,
+            description: "Directory to package into source.tar.gz. The directory's contents " +
+                "are uploaded verbatim — exclude `.git`, `node_modules`, build " +
+                "artefacts and any other paths you don't want sent to Meticulous " +
+                "before invoking this command.",
+        },
+    },
+    handler: (0, sentry_utils_1.wrapHandler)(async ({ apiToken, commitSha, sourceDir }) => {
+        const logger = (0, common_1.initLogger)();
+        const client = (0, client_1.createClient)({ apiToken });
+        const tmpDir = await (0, promises_1.mkdtemp)((0, path_1.join)((0, os_1.tmpdir)(), "meticulous-source-"));
+        const archivePath = (0, path_1.join)(tmpDir, "source.tar.gz");
+        try {
+            logger.info(`Packaging ${sourceDir} into ${archivePath}...`);
+            // We package `sourceDir` verbatim: no `.gitignore` parsing, no
+            // filtering. The caller is responsible for pointing at a directory
+            // that contains only what Meticulous needs — see the JSDoc above.
+            // `portable` produces reproducible archives across platforms; `gzip`
+            // gives us the `.gz` wire format the cloud worker decompresses with
+            // `streamDownloadAndExtractTarGz`.
+            await (0, promises_2.pipeline)((0, tar_1.create)({
+                cwd: sourceDir,
+                gzip: true,
+                portable: true,
+            }, ["."]), (0, fs_1.createWriteStream)(archivePath));
+            const { size } = (0, fs_1.statSync)(archivePath);
+            logger.info(`Archive ready: ${(size / (1024 * 1024)).toFixed(2)} MiB. Requesting upload URL...`);
+            const { uploadUrl } = await (0, client_1.requestSourceCodeUploadUrl)({
+                client,
+                commitSha,
+                size,
+            });
+            logger.info(`Uploading source archive for commit ${commitSha}...`);
+            await (0, client_1.retryTransientUploadErrors)(() => (0, client_1.putFileToSignedUrl)({
+                filePath: archivePath,
+                signedUrl: uploadUrl,
+                size,
+                contentType: "application/gzip",
+            }), {
+                onRetry: (attempt, error) => {
+                    const reason = error instanceof client_1.UploadError
+                        ? `HTTP ${error.statusCode}`
+                        : error instanceof Error
+                            ? error.message
+                            : String(error);
+                    logger.warn(`Transient upload error on attempt ${attempt} (${reason}); will retry...`);
+                },
+            });
+            logger.info(`Successfully uploaded source archive for commit ${commitSha}.`);
+        }
+        finally {
+            await (0, promises_1.rm)(tmpDir, { recursive: true, force: true });
+        }
+    }),
+};
+//# sourceMappingURL=upload-source.command.js.map
+//# debugId=80bf9498-6e60-5fd3-8e7a-5798f20c3eed

package/dist/commands/project/upload-source.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-source.command.js","sources":["../../../src/commands/project/upload-source.command.ts"],"sourceRoot":"","names":[],"mappings":"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","debugId":"80bf9498-6e60-5fd3-8e7a-5798f20c3eed"}

package/dist/utils/constants.d.ts

@@ -1 +1,2 @@
 export declare const RECORDING_SNIPPET_PATH = "v1/meticulous.js";
+export declare const BACKEND_RECORDING_SNIPPET_PATH = "backend-record-js/v1/manual-init.bundle.js";

package/dist/utils/constants.js

@@ -1,8 +1,9 @@
 "use strict";
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="07ec876f-a641-5fc6-b375-8f126b6afe4a")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="797d4326-b2e4-560d-8e44-4dc471c92cac")}catch(e){}}();
 
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RECORDING_SNIPPET_PATH = void 0;
+exports.BACKEND_RECORDING_SNIPPET_PATH = exports.RECORDING_SNIPPET_PATH = void 0;
 exports.RECORDING_SNIPPET_PATH = "v1/meticulous.js";
+exports.BACKEND_RECORDING_SNIPPET_PATH = "backend-record-js/v1/manual-init.bundle.js";
 //# sourceMappingURL=constants.js.map
-//# debugId=07ec876f-a641-5fc6-b375-8f126b6afe4a
+//# debugId=797d4326-b2e4-560d-8e44-4dc471c92cac

package/dist/utils/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sources":["../../src/utils/constants.ts"],"sourceRoot":"","names":[],"mappings":";;;;;AAAa,QAAA,sBAAsB,GAAG,kBAAkB,CAAC","debugId":"07ec876f-a641-5fc6-b375-8f126b6afe4a"}
+{"version":3,"file":"constants.js","sources":["../../src/utils/constants.ts"],"sourceRoot":"","names":[],"mappings":";;;;;AAAa,QAAA,sBAAsB,GAAG,kBAAkB,CAAC;AAC5C,QAAA,8BAA8B,GACzC,4CAA4C,CAAC","debugId":"797d4326-b2e4-560d-8e44-4dc471c92cac"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alwaysmeticulous/cli",
-  "version": "2.279.0",
+  "version": "2.280.0",
   "description": "The Meticulous CLI",
   "license": "ISC",
   "main": "dist/index.js",
@@ -29,18 +29,18 @@
     "depcheck": "depcheck --ignore-patterns=dist"
   },
   "dependencies": {
-    "@alwaysmeticulous/api": "2.276.2",
-    "@alwaysmeticulous/client": "2.277.0",
-    "@alwaysmeticulous/common": "2.277.0",
-    "@alwaysmeticulous/debug-workspace": "2.278.0",
-    "@alwaysmeticulous/downloading-helpers": "2.277.0",
-    "@alwaysmeticulous/record": "2.277.0",
-    "@alwaysmeticulous/remote-replay-launcher": "2.277.0",
-    "@alwaysmeticulous/replay-debugger-ui": "2.277.0",
-    "@alwaysmeticulous/replay-orchestrator-launcher": "2.277.0",
-    "@alwaysmeticulous/sdk-bundles-api": "2.277.0",
-    "@alwaysmeticulous/sentry": "2.277.0",
-    "@alwaysmeticulous/tunnels-client": "2.277.0",
+    "@alwaysmeticulous/api": "2.280.0",
+    "@alwaysmeticulous/client": "2.280.0",
+    "@alwaysmeticulous/common": "2.280.0",
+    "@alwaysmeticulous/debug-workspace": "2.280.0",
+    "@alwaysmeticulous/downloading-helpers": "2.280.0",
+    "@alwaysmeticulous/record": "2.280.0",
+    "@alwaysmeticulous/remote-replay-launcher": "2.280.0",
+    "@alwaysmeticulous/replay-debugger-ui": "2.280.0",
+    "@alwaysmeticulous/replay-orchestrator-launcher": "2.280.0",
+    "@alwaysmeticulous/sdk-bundles-api": "2.280.0",
+    "@alwaysmeticulous/sentry": "2.280.0",
+    "@alwaysmeticulous/tunnels-client": "2.280.0",
     "@sentry/node": "^10.3.0",
     "chalk": "^4.1.2",
     "ci-info": "^4.0.0",
@@ -49,6 +49,7 @@
     "ora": "^5.4.1",
     "parse-diff": "^0.11.1",
     "puppeteer-core": "24.14.0",
+    "tar": "^7.5.8",
     "yargs": "^17.5.1"
   },
   "devDependencies": {
@@ -75,5 +76,5 @@
   "bugs": {
     "url": "https://github.com/alwaysmeticulous/meticulous-sdk/issues"
   },
-  "gitHead": "45f95ba2250c5e71034a848bc8031cddb5cf105c"
+  "gitHead": "87ca975a232d16ea878caa5649a8b21221ebca02"
 }