@mondaydotcomorg/z2h-cli 0.33.3 → 0.33.4

package/dist/commands/backend.d.ts

@@ -1,4 +1,3 @@
-export declare function hasHandlers(appDir: string): boolean;
 export interface ReadDetectAndUploadResult {
     integrations: string[];
     handlerNames: string[];

package/dist/commands/backend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../src/commands/backend.ts"],"names":[],"mappings":"AAyBA,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEnD;AAoBD,MAAM,WAAW,yBAAyB;IACxC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAiCD;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;CACpB,GAAG,OAAO,CAAC,yBAAyB,CAAC,CASrC;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,MAAM,GAAE,MAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAe1F;AAsBD;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,EAC5C,MAAM,GAAE,MAAsB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAqBf"}
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../src/commands/backend.ts"],"names":[],"mappings":"AAyBA,MAAM,WAAW,yBAAyB;IACxC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AA+BD;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;CACpB,GAAG,OAAO,CAAC,yBAAyB,CAAC,CASrC;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,MAAM,GAAE,MAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAe1F;AAsBD;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,EAC5C,MAAM,GAAE,MAAsB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAqBf"}

package/dist/commands/backend.js

@@ -1,9 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
 const path = require('node:path');
-const fs = require('node:fs');
 const promises = require('node:fs/promises');
-const fs$1 = require('fs-extra');
+const fs = require('fs-extra');
 const clientS3 = require('@aws-sdk/client-s3');
 const util_logger = require('../util/logger.js');
 const util_appName = require('../util/app-name.js');
@@ -16,6 +15,7 @@ const backend_client = require('../backend/client.js');
 const backend_formatSandboxRun = require('../backend/format-sandbox-run.js');
 const backend_validate = require('../backend/validate.js');
 const util_errors = require('../util/errors.js');
+const util_usageJson = require('../util/usage-json.js');
 
 const _interopDefault = e => e && e.__esModule ? e : { default: e };
 
@@ -28,36 +28,14 @@ function currentAppName() {
     }
     return util_appName.mfAppName(raw);
 }
-function hasHandlers(appDir) {
-    return fs.existsSync(path__default.default.join(appDir, 'backend', 'handlers'));
-}
-/** Other features may add top-level fields, so writes below merge into this copy instead of replacing it. */
-async function readExistingUsage(appDir) {
-    try {
-        return (await fs$1.readJson(path__default.default.join(appDir, 'usage.json')));
-    }
-    catch (err) {
-        if (err.code === 'ENOENT') {
-            return {};
-        }
-        throw err;
-    }
-}
-/** Keeps the app's git-tracked `usage.json` current with every handler parse (validate or deploy). */
-async function writeUsageJson(appDir, patch) {
-    const existing = await readExistingUsage(appDir);
-    await fs$1.writeJson(path__default.default.join(appDir, 'usage.json'), { ...existing, ...patch }, { spaces: 2 });
-}
 async function readDetectAndUpload(appDir, prefix, appName, version, deployedBy, logLabel) {
-    if (!hasHandlers(appDir)) {
-        await writeUsageJson(appDir, { appName, deployedBy, apiUsages: {} });
+    if (!util_usageJson.hasHandlers(appDir)) {
         return { integrations: [], handlerNames: [], apiUsages: {} };
     }
     util_logger.info(`reading backend handlers ${logLabel}`);
     const { handlers, apiDomains, apiUsages } = await backend_handlers.readHandlers(appDir);
     const integrations = backend_detectIntegrations.detectIntegrations(apiDomains);
     const handlerNames = Object.keys(handlers);
-    await writeUsageJson(appDir, { appName, deployedBy, apiUsages });
     if (Object.keys(handlers).length === 0) {
         return { integrations, handlerNames, apiUsages };
     }
@@ -93,15 +71,15 @@ async function deployBackend(opts) {
  * local `usage.json` — no upload to S3. Throws on the first invalid handler.
  */
 async function backendValidateCommand(appDir = process.cwd()) {
-    if (!hasHandlers(appDir)) {
+    if (!util_usageJson.hasHandlers(appDir)) {
         util_logger.output('[z2h-cli] no backend/handlers/ directory — nothing to validate', { handlers: [], integrations: [] });
         return;
     }
     const { handlers, apiDomains, apiUsages } = await backend_handlers.readHandlers(appDir);
     const names = Object.keys(handlers).sort();
     const integrations = backend_detectIntegrations.detectIntegrations(apiDomains);
-    const { name } = (await fs$1.readJson(path__default.default.join(appDir, 'package.json')));
-    await writeUsageJson(appDir, { appName: name ? util_appName.mfAppName(name) : undefined, deployedBy: util_machineIdentity.whoAmI(), apiUsages });
+    const { name } = (await fs.readJson(path__default.default.join(appDir, 'package.json')));
+    await util_usageJson.writeUsageJson(appDir, { appName: name ? util_appName.mfAppName(name) : undefined, deployedBy: util_machineIdentity.whoAmI(), apiUsages });
     const list = (xs) => (xs.length ? xs.join(', ') : 'none');
     util_logger.output(`[z2h-cli] ${names.length} handler(s) valid: ${list(names)}\n[z2h-cli] integrations: ${list(integrations)}`, {
         handlers: names,
@@ -117,7 +95,7 @@ async function readHandlerSource(appDir, handlerName) {
         if (err.code !== 'ENOENT') {
             throw err;
         }
-        const files = hasHandlers(appDir) ? await promises.readdir(dir) : [];
+        const files = util_usageJson.hasHandlers(appDir) ? await promises.readdir(dir) : [];
         const available = files
             .filter(f => f.endsWith('.js'))
             .map(f => path__default.default.parse(f).name)
@@ -155,4 +133,3 @@ async function backendInvokeCommand(handlerName, opts = {}, appDir = process.cwd
 exports.backendInvokeCommand = backendInvokeCommand;
 exports.backendValidateCommand = backendValidateCommand;
 exports.deployBackend = deployBackend;
-exports.hasHandlers = hasHandlers;

package/dist/commands/deploy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../src/commands/deploy.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,KAAK,UAAU,EAA2C,MAAM,4BAA4B,CAAC;AAatG,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IAIrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAWD,wBAAsB,aAAa,CAAC,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyB3E"}
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../src/commands/deploy.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,KAAK,UAAU,EAA2C,MAAM,4BAA4B,CAAC;AAatG,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IAIrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAWD,wBAAsB,aAAa,CAAC,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyB3E"}

package/dist/commands/deploy.js

@@ -11,6 +11,7 @@ const util_auth_brokerCredentialProvider = require('../util/auth/broker-credenti
 const util_auth_authStore = require('../util/auth/auth-store.js');
 const util_appName = require('../util/app-name.js');
 const util_git_repo = require('../util/git/repo.js');
+const util_usageJson = require('../util/usage-json.js');
 const util_git_gitEnv = require('../util/git/git-env.js');
 const util_git_remoteOptions = require('../util/git/remote-options.js');
 const util_s3_client = require('../util/s3/client.js');
@@ -216,6 +217,7 @@ async function deployLive({ paths, consumerName, appName, token, opts }) {
             await util_git_repo.guardCleanTree(process.cwd());
             util_logger.info('syncing with git remote');
             await util_git_repo.pullAndResolve(process.cwd(), gitEnv);
+            await util_usageJson.updateOrCreateUsageJson(process.cwd(), appName, util_machineIdentity.whoAmI());
         }
         catch (err) {
             throw util_errors.tagDeployError('git_error', err);

package/dist/esm/commands/backend.d.ts

@@ -1,4 +1,3 @@
-export declare function hasHandlers(appDir: string): boolean;
 export interface ReadDetectAndUploadResult {
     integrations: string[];
     handlerNames: string[];

package/dist/esm/commands/backend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../../src/commands/backend.ts"],"names":[],"mappings":"AAyBA,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEnD;AAoBD,MAAM,WAAW,yBAAyB;IACxC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAiCD;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;CACpB,GAAG,OAAO,CAAC,yBAAyB,CAAC,CASrC;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,MAAM,GAAE,MAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAe1F;AAsBD;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,EAC5C,MAAM,GAAE,MAAsB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAqBf"}
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../../src/commands/backend.ts"],"names":[],"mappings":"AAyBA,MAAM,WAAW,yBAAyB;IACxC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AA+BD;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;CACpB,GAAG,OAAO,CAAC,yBAAyB,CAAC,CASrC;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,MAAM,GAAE,MAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAe1F;AAsBD;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,EAC5C,MAAM,GAAE,MAAsB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAqBf"}

package/dist/esm/commands/backend.mjs

@@ -1,7 +1,6 @@
 import path from 'node:path';
-import { existsSync } from 'node:fs';
 import { readFile, readdir } from 'node:fs/promises';
-import { readJson, writeJson } from 'fs-extra';
+import { readJson } from 'fs-extra';
 import { PutObjectCommand } from '@aws-sdk/client-s3';
 import { output, info } from '../util/logger.mjs';
 import { mfAppName, getCwdAppName } from '../util/app-name.mjs';
@@ -14,6 +13,7 @@ import { runSandbox } from '../backend/client.mjs';
 import { formatSandboxRun } from '../backend/format-sandbox-run.mjs';
 import { validateHandlerSource } from '../backend/validate.mjs';
 import { tagDeployError } from '../util/errors.mjs';
+import { hasHandlers, writeUsageJson } from '../util/usage-json.mjs';
 
 function currentAppName() {
     const raw = getCwdAppName();
@@ -22,36 +22,14 @@ function currentAppName() {
     }
     return mfAppName(raw);
 }
-function hasHandlers(appDir) {
-    return existsSync(path.join(appDir, 'backend', 'handlers'));
-}
-/** Other features may add top-level fields, so writes below merge into this copy instead of replacing it. */
-async function readExistingUsage(appDir) {
-    try {
-        return (await readJson(path.join(appDir, 'usage.json')));
-    }
-    catch (err) {
-        if (err.code === 'ENOENT') {
-            return {};
-        }
-        throw err;
-    }
-}
-/** Keeps the app's git-tracked `usage.json` current with every handler parse (validate or deploy). */
-async function writeUsageJson(appDir, patch) {
-    const existing = await readExistingUsage(appDir);
-    await writeJson(path.join(appDir, 'usage.json'), { ...existing, ...patch }, { spaces: 2 });
-}
 async function readDetectAndUpload(appDir, prefix, appName, version, deployedBy, logLabel) {
     if (!hasHandlers(appDir)) {
-        await writeUsageJson(appDir, { appName, deployedBy, apiUsages: {} });
         return { integrations: [], handlerNames: [], apiUsages: {} };
     }
     info(`reading backend handlers ${logLabel}`);
     const { handlers, apiDomains, apiUsages } = await readHandlers(appDir);
     const integrations = detectIntegrations(apiDomains);
     const handlerNames = Object.keys(handlers);
-    await writeUsageJson(appDir, { appName, deployedBy, apiUsages });
     if (Object.keys(handlers).length === 0) {
         return { integrations, handlerNames, apiUsages };
     }
@@ -146,4 +124,4 @@ async function backendInvokeCommand(handlerName, opts = {}, appDir = process.cwd
     }
 }
 
-export { backendInvokeCommand, backendValidateCommand, deployBackend, hasHandlers };
+export { backendInvokeCommand, backendValidateCommand, deployBackend };

package/dist/esm/commands/deploy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../../src/commands/deploy.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,KAAK,UAAU,EAA2C,MAAM,4BAA4B,CAAC;AAatG,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IAIrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAWD,wBAAsB,aAAa,CAAC,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyB3E"}
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../../src/commands/deploy.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,KAAK,UAAU,EAA2C,MAAM,4BAA4B,CAAC;AAatG,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IAIrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAWD,wBAAsB,aAAa,CAAC,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyB3E"}

package/dist/esm/commands/deploy.mjs

@@ -9,6 +9,7 @@ import { fetchDeployVersion, brokerCredentialProvider } from '../util/auth/broke
 import { readZthAuth } from '../util/auth/auth-store.mjs';
 import { validateAppName, cleanAppName, mfAppName, buildPreviewSlug } from '../util/app-name.mjs';
 import { getRemoteUrl, initRepo, guardCleanTree, pullAndResolve, pushToRemote } from '../util/git/repo.mjs';
+import { updateOrCreateUsageJson } from '../util/usage-json.mjs';
 import { resolveGitEnv } from '../util/git/git-env.mjs';
 import { validateRemoteOptions, resolveRemoteUrl } from '../util/git/remote-options.mjs';
 import { setupS3Client } from '../util/s3/client.mjs';
@@ -210,6 +211,7 @@ async function deployLive({ paths, consumerName, appName, token, opts }) {
             await guardCleanTree(process.cwd());
             info('syncing with git remote');
             await pullAndResolve(process.cwd(), gitEnv);
+            await updateOrCreateUsageJson(process.cwd(), appName, whoAmI());
         }
         catch (err) {
             throw tagDeployError('git_error', err);

package/dist/esm/util/__tests__/usage-json.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=usage-json.test.d.ts.map

package/dist/esm/util/__tests__/usage-json.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-json.test.d.ts","sourceRoot":"","sources":["../../../../src/util/__tests__/usage-json.test.ts"],"names":[],"mappings":""}

package/dist/esm/util/git/repo.d.ts

@@ -1,3 +1,8 @@
+type GitEnv = Record<string, string | undefined>;
+export declare function execGit(args: string[], dir: string, env?: GitEnv): import("execa").ResultPromise<{
+    cwd: string;
+    env: GitEnv | undefined;
+}>;
 export interface ConflictInfo {
     localCommits: string[];
     remoteCommits: string[];
@@ -25,4 +30,5 @@ export declare function pullAndResolve(dir: string, env?: Record<string, string>
 export declare function pushToRemote(dir: string, env?: Record<string, string>): Promise<void>;
 export declare function remoteHead(dir: string): Promise<string>;
 export declare function localHead(dir: string): Promise<string>;
+export {};
 //# sourceMappingURL=repo.d.ts.map

package/dist/esm/util/git/repo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repo.d.ts","sourceRoot":"","sources":["../../../../src/util/git/repo.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAKD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOzE;AAED,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAI3E;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAK/D;AAED,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG5G;AAED,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAclE;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CA2B7F;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB3F;AAED,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAO7D;AAED,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAG5D"}
+{"version":3,"file":"repo.d.ts","sourceRoot":"","sources":["../../../../src/util/git/repo.ts"],"names":[],"mappings":"AAOA,KAAK,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAEjD,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM;;;GAEhE;AAQD,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAKD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOzE;AAED,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAI3E;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAK/D;AAED,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG5G;AAED,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAclE;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CA2B7F;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB3F;AAED,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAO7D;AAED,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAG5D"}

package/dist/esm/util/git/repo.mjs

@@ -171,4 +171,4 @@ async function ensureGitignore(dir) {
     await fs.outputFile(gitignorePath, content + separator + missing.join('\n') + '\n');
 }
 
-export { cloneRepo, defaultS3Remote, getRemoteUrl, guardCleanTree, initRepo, localHead, pullAndResolve, pushToRemote, remoteHead, safeBackupIfDirty };
+export { cloneRepo, defaultS3Remote, execGit, getRemoteUrl, guardCleanTree, initRepo, localHead, pullAndResolve, pushToRemote, remoteHead, safeBackupIfDirty };

package/dist/esm/util/usage-json.d.ts

@@ -0,0 +1,6 @@
+export declare function hasHandlers(appDir: string): boolean;
+/** Other features may add top-level fields, so writes merge into the existing file instead of replacing it. */
+export declare function writeUsageJson(appDir: string, patch: Record<string, unknown>): Promise<void>;
+/** Refreshes the git-tracked `usage.json` and commits it if it changed, so a deploy's push carries it. */
+export declare function updateOrCreateUsageJson(appDir: string, appName: string, deployedBy: string): Promise<void>;
+//# sourceMappingURL=usage-json.d.ts.map

package/dist/esm/util/usage-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-json.d.ts","sourceRoot":"","sources":["../../../src/util/usage-json.ts"],"names":[],"mappings":"AAOA,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,+GAA+G;AAC/G,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAWlG;AAED,0GAA0G;AAC1G,wBAAsB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQhH"}

package/dist/esm/util/usage-json.mjs

@@ -0,0 +1,36 @@
+import path from 'node:path';
+import { existsSync } from 'node:fs';
+import { readJson, writeJson } from 'fs-extra';
+import { execa } from 'execa';
+import { readHandlers } from '../backend/handlers.mjs';
+import { execGit } from './git/repo.mjs';
+
+function hasHandlers(appDir) {
+    return existsSync(path.join(appDir, 'backend', 'handlers'));
+}
+/** Other features may add top-level fields, so writes merge into the existing file instead of replacing it. */
+async function writeUsageJson(appDir, patch) {
+    const file = path.join(appDir, 'usage.json');
+    let existing = {};
+    try {
+        existing = await readJson(file);
+    }
+    catch (err) {
+        if (err.code !== 'ENOENT') {
+            throw err;
+        }
+    }
+    await writeJson(file, { ...existing, ...patch }, { spaces: 2 });
+}
+/** Refreshes the git-tracked `usage.json` and commits it if it changed, so a deploy's push carries it. */
+async function updateOrCreateUsageJson(appDir, appName, deployedBy) {
+    const apiUsages = hasHandlers(appDir) ? (await readHandlers(appDir)).apiUsages : {};
+    await writeUsageJson(appDir, { appName, deployedBy, apiUsages });
+    await execGit(['add', 'usage.json'], appDir);
+    const { exitCode } = await execa('git', ['diff', '--cached', '--quiet'], { cwd: appDir, reject: false });
+    if (exitCode !== 0) {
+        await execGit(['commit', '-m', 'Update usage.json'], appDir);
+    }
+}
+
+export { hasHandlers, updateOrCreateUsageJson, writeUsageJson };

package/dist/util/__tests__/usage-json.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=usage-json.test.d.ts.map

package/dist/util/__tests__/usage-json.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-json.test.d.ts","sourceRoot":"","sources":["../../../src/util/__tests__/usage-json.test.ts"],"names":[],"mappings":""}

package/dist/util/git/repo.d.ts

@@ -1,3 +1,8 @@
+type GitEnv = Record<string, string | undefined>;
+export declare function execGit(args: string[], dir: string, env?: GitEnv): import("execa").ResultPromise<{
+    cwd: string;
+    env: GitEnv | undefined;
+}>;
 export interface ConflictInfo {
     localCommits: string[];
     remoteCommits: string[];
@@ -25,4 +30,5 @@ export declare function pullAndResolve(dir: string, env?: Record<string, string>
 export declare function pushToRemote(dir: string, env?: Record<string, string>): Promise<void>;
 export declare function remoteHead(dir: string): Promise<string>;
 export declare function localHead(dir: string): Promise<string>;
+export {};
 //# sourceMappingURL=repo.d.ts.map

package/dist/util/git/repo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repo.d.ts","sourceRoot":"","sources":["../../../src/util/git/repo.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAKD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOzE;AAED,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAI3E;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAK/D;AAED,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG5G;AAED,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAclE;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CA2B7F;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB3F;AAED,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAO7D;AAED,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAG5D"}
+{"version":3,"file":"repo.d.ts","sourceRoot":"","sources":["../../../src/util/git/repo.ts"],"names":[],"mappings":"AAOA,KAAK,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAEjD,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM;;;GAEhE;AAQD,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAKD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOzE;AAED,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAI3E;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAK/D;AAED,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG5G;AAED,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAclE;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CA2B7F;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB3F;AAED,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAO7D;AAED,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAG5D"}

package/dist/util/git/repo.js

@@ -180,6 +180,7 @@ async function ensureGitignore(dir) {
 
 exports.cloneRepo = cloneRepo;
 exports.defaultS3Remote = defaultS3Remote;
+exports.execGit = execGit;
 exports.getRemoteUrl = getRemoteUrl;
 exports.guardCleanTree = guardCleanTree;
 exports.initRepo = initRepo;

package/dist/util/usage-json.d.ts

@@ -0,0 +1,6 @@
+export declare function hasHandlers(appDir: string): boolean;
+/** Other features may add top-level fields, so writes merge into the existing file instead of replacing it. */
+export declare function writeUsageJson(appDir: string, patch: Record<string, unknown>): Promise<void>;
+/** Refreshes the git-tracked `usage.json` and commits it if it changed, so a deploy's push carries it. */
+export declare function updateOrCreateUsageJson(appDir: string, appName: string, deployedBy: string): Promise<void>;
+//# sourceMappingURL=usage-json.d.ts.map

package/dist/util/usage-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-json.d.ts","sourceRoot":"","sources":["../../src/util/usage-json.ts"],"names":[],"mappings":"AAOA,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,+GAA+G;AAC/G,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAWlG;AAED,0GAA0G;AAC1G,wBAAsB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQhH"}

package/dist/util/usage-json.js

@@ -0,0 +1,44 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const path = require('node:path');
+const fs = require('node:fs');
+const fs$1 = require('fs-extra');
+const execa = require('execa');
+const backend_handlers = require('../backend/handlers.js');
+const util_git_repo = require('./git/repo.js');
+
+const _interopDefault = e => e && e.__esModule ? e : { default: e };
+
+const path__default = /*#__PURE__*/_interopDefault(path);
+
+function hasHandlers(appDir) {
+    return fs.existsSync(path__default.default.join(appDir, 'backend', 'handlers'));
+}
+/** Other features may add top-level fields, so writes merge into the existing file instead of replacing it. */
+async function writeUsageJson(appDir, patch) {
+    const file = path__default.default.join(appDir, 'usage.json');
+    let existing = {};
+    try {
+        existing = await fs$1.readJson(file);
+    }
+    catch (err) {
+        if (err.code !== 'ENOENT') {
+            throw err;
+        }
+    }
+    await fs$1.writeJson(file, { ...existing, ...patch }, { spaces: 2 });
+}
+/** Refreshes the git-tracked `usage.json` and commits it if it changed, so a deploy's push carries it. */
+async function updateOrCreateUsageJson(appDir, appName, deployedBy) {
+    const apiUsages = hasHandlers(appDir) ? (await backend_handlers.readHandlers(appDir)).apiUsages : {};
+    await writeUsageJson(appDir, { appName, deployedBy, apiUsages });
+    await util_git_repo.execGit(['add', 'usage.json'], appDir);
+    const { exitCode } = await execa.execa('git', ['diff', '--cached', '--quiet'], { cwd: appDir, reject: false });
+    if (exitCode !== 0) {
+        await util_git_repo.execGit(['commit', '-m', 'Update usage.json'], appDir);
+    }
+}
+
+exports.hasHandlers = hasHandlers;
+exports.updateOrCreateUsageJson = updateOrCreateUsageJson;
+exports.writeUsageJson = writeUsageJson;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mondaydotcomorg/z2h-cli",
-  "version": "0.33.3",
+  "version": "0.33.4",
   "bin": "./bin/z2h-cli.js",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/src/commands/__tests__/backend-deploy.test.ts

@@ -1,9 +1,10 @@
 import path from 'node:path';
 import os from 'node:os';
-import { mkdtemp, rm, ensureDir, writeFile, writeJson, readJson, pathExists } from 'fs-extra';
+import { mkdtemp, rm, ensureDir, writeFile } from 'fs-extra';
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 
-import { deployBackend, hasHandlers } from '../backend';
+import { deployBackend } from '../backend';
+import { hasHandlers } from '../../util/usage-json';
 import { readHandlers } from '../../backend/handlers';
 import { DeployError } from '../../util/errors';
 
@@ -63,7 +64,7 @@ describe('deployBackend (live)', () => {
     await rm(tmp, { recursive: true, force: true });
   });
 
-  it('skips upload and resets usage.json when there is no handlers directory', async () => {
+  it('skips upload when there is no handlers directory', async () => {
     // hasHandlers is false here, so readHandlers is never reached — no mock needed.
     await expect(
       deployBackend({
@@ -76,16 +77,10 @@ describe('deployBackend (live)', () => {
       })
     ).resolves.toEqual({ integrations: [], handlerNames: [], apiUsages: {} });
     expect(mockSend).not.toHaveBeenCalled();
-    await expect(readJson(path.join(tmp, 'usage.json'))).resolves.toEqual({
-      appName: 'mf-my-app',
-      deployedBy: 'test-user',
-      apiUsages: {},
-    });
   });
 
-  it('skips upload and resets usage.json when backend/handlers exists but has no handler sources', async () => {
+  it('skips upload when backend/handlers exists but has no handler sources', async () => {
     await ensureDir(path.join(tmp, 'backend', 'handlers'));
-    await writeJson(path.join(tmp, 'usage.json'), { apiUsages: { deleted_handler: {} }, keepMe: 1 });
     readHandlersMock.mockResolvedValue({ handlers: {}, apiDomains: [], apiUsages: {} });
 
     await expect(
@@ -99,12 +94,6 @@ describe('deployBackend (live)', () => {
       })
     ).resolves.toEqual({ integrations: [], handlerNames: [], apiUsages: {} });
     expect(mockSend).not.toHaveBeenCalled();
-    await expect(readJson(path.join(tmp, 'usage.json'))).resolves.toEqual({
-      keepMe: 1,
-      appName: 'mf-my-app',
-      deployedBy: 'test-user',
-      apiUsages: {},
-    });
   });
 
   it('transpiles and uploads handlers when backend/handlers exists', async () => {
@@ -144,54 +133,6 @@ describe('deployBackend (live)', () => {
     );
     const meta = JSON.parse((metaCall![0] as { input: { Body: string } }).input.Body);
     expect(meta).toEqual({ version: 1, deployedBy: 'test-user', handlers: ['call_snowflake'] });
-
-    await expect(readJson(path.join(tmp, 'usage.json'))).resolves.toEqual({
-      appName: 'mf-my-app',
-      deployedBy: 'test-user',
-      apiUsages: { call_snowflake: { snowflake: { query: [{ sql: 'x' }] } } },
-    });
-  });
-
-  it('writes usage.json locally even for apps that had none yet', async () => {
-    await ensureDir(path.join(tmp, 'backend', 'handlers'));
-    await expect(pathExists(path.join(tmp, 'usage.json'))).resolves.toBe(false);
-
-    await deployBackend({
-      appDir: tmp,
-      appName: 'mf-my-app',
-      mfKeyPrefix: 'mf-my-app/1',
-      version: 1,
-      deployedBy: 'test-user',
-      isPreview: false,
-    });
-
-    expect(mockSend).toHaveBeenCalled();
-    await expect(readJson(path.join(tmp, 'usage.json'))).resolves.toEqual({
-      appName: 'mf-my-app',
-      deployedBy: 'test-user',
-      apiUsages: { call_snowflake: {} },
-    });
-  });
-
-  it('merges the local usage.json instead of overwriting it, and writes the merged result back locally', async () => {
-    await ensureDir(path.join(tmp, 'backend', 'handlers'));
-    await writeJson(path.join(tmp, 'usage.json'), { someOtherFeatureField: 'keep-me' });
-
-    await deployBackend({
-      appDir: tmp,
-      appName: 'mf-my-app',
-      mfKeyPrefix: 'mf-my-app/1',
-      version: 1,
-      deployedBy: 'test-user',
-      isPreview: false,
-    });
-
-    await expect(readJson(path.join(tmp, 'usage.json'))).resolves.toEqual({
-      someOtherFeatureField: 'keep-me',
-      appName: 'mf-my-app',
-      deployedBy: 'test-user',
-      apiUsages: { call_snowflake: {} },
-    });
   });
 
   it('tags a handler upload failure as deploy_backend_error, not register_error', async () => {

package/src/commands/__tests__/deploy.test.ts

@@ -17,6 +17,7 @@ import * as brokerProvider from '../../util/auth/broker-credential-provider';
 import * as brokerApp from '../../util/broker/app';
 import * as authStore from '../../util/auth/auth-store';
 import * as gitRepo from '../../util/git/repo';
+import { updateOrCreateUsageJson } from '../../util/usage-json';
 
 vi.mock('../build', () => ({
   buildCommand: vi.fn(),
@@ -67,6 +68,11 @@ vi.mock('../../util/broker/app', () => ({
   fetchApp: vi.fn().mockResolvedValue(STUB_MASTER_APP),
 }));
 
+vi.mock('../../util/usage-json', async importOriginal => ({
+  ...(await importOriginal<typeof import('../../util/usage-json')>()),
+  updateOrCreateUsageJson: vi.fn(),
+}));
+
 vi.mock('../../util/git/repo', () => ({
   getRemoteUrl: vi.fn(),
   guardCleanTree: vi.fn(),
@@ -218,6 +224,7 @@ describe('deploy --preview', () => {
     expect(gitRepo.guardCleanTree).not.toHaveBeenCalled();
     expect(gitRepo.pullAndResolve).not.toHaveBeenCalled();
     expect(gitRepo.pushToRemote).not.toHaveBeenCalled();
+    expect(updateOrCreateUsageJson).not.toHaveBeenCalled();
     expect(gitRepo.initRepo).not.toHaveBeenCalled();
   });
 
@@ -405,6 +412,16 @@ describe('deploy failure reasons', () => {
     expect((await failedDeploy()).reason).toBe('broker_error');
   });
 
+  it('updates usage.json before pushing on a live deploy', async () => {
+    vi.stubGlobal('fetch', vi.fn().mockResolvedValue({ ok: true, status: 200, text: async () => '' }));
+    vi.mocked(updateOrCreateUsageJson).mockReset().mockResolvedValue(undefined);
+    vi.mocked(gitRepo.pushToRemote).mockReset().mockRejectedValue(new Error('stop after push'));
+    await deployCommand().catch(() => {});
+    const [usageOrder] = vi.mocked(updateOrCreateUsageJson).mock.invocationCallOrder;
+    const [pushOrder] = vi.mocked(gitRepo.pushToRemote).mock.invocationCallOrder;
+    expect(usageOrder).toBeLessThan(pushOrder);
+  });
+
   // buildCommand throws plain errors (see commands/__tests__/build.test.ts), so a build
   // failure surfaces as untagged here — see the propagation test below. The STS 401/403 →
   // auth tagging lives in broker-credential-provider.ts — see its own test file.

package/src/commands/backend.ts

@@ -1,7 +1,6 @@
 import path from 'node:path';
-import { existsSync } from 'node:fs';
 import { readdir, readFile } from 'node:fs/promises';
-import { readJson, writeJson } from 'fs-extra';
+import { readJson } from 'fs-extra';
 import { PutObjectCommand } from '@aws-sdk/client-s3';
 import { info, output } from '../util/logger';
 import { mfAppName, getCwdAppName } from '../util/app-name';
@@ -14,6 +13,7 @@ import { runSandbox } from '../backend/client';
 import { formatSandboxRun } from '../backend/format-sandbox-run';
 import { validateHandlerSource } from '../backend/validate';
 import { tagDeployError } from '../util/errors';
+import { hasHandlers, writeUsageJson } from '../util/usage-json';
 
 function currentAppName(): string {
   const raw = getCwdAppName();
@@ -23,28 +23,6 @@ function currentAppName(): string {
   return mfAppName(raw);
 }
 
-export function hasHandlers(appDir: string): boolean {
-  return existsSync(path.join(appDir, 'backend', 'handlers'));
-}
-
-/** Other features may add top-level fields, so writes below merge into this copy instead of replacing it. */
-async function readExistingUsage(appDir: string): Promise<Record<string, unknown>> {
-  try {
-    return (await readJson(path.join(appDir, 'usage.json'))) as Record<string, unknown>;
-  } catch (err) {
-    if ((err as { code?: string }).code === 'ENOENT') {
-      return {};
-    }
-    throw err;
-  }
-}
-
-/** Keeps the app's git-tracked `usage.json` current with every handler parse (validate or deploy). */
-async function writeUsageJson(appDir: string, patch: Record<string, unknown>): Promise<void> {
-  const existing = await readExistingUsage(appDir);
-  await writeJson(path.join(appDir, 'usage.json'), { ...existing, ...patch }, { spaces: 2 });
-}
-
 export interface ReadDetectAndUploadResult {
   integrations: string[];
   handlerNames: string[];
@@ -60,14 +38,12 @@ async function readDetectAndUpload(
   logLabel: string
 ): Promise<ReadDetectAndUploadResult> {
   if (!hasHandlers(appDir)) {
-    await writeUsageJson(appDir, { appName, deployedBy, apiUsages: {} });
     return { integrations: [], handlerNames: [], apiUsages: {} };
   }
   info(`reading backend handlers ${logLabel}`);
   const { handlers, apiDomains, apiUsages } = await readHandlers(appDir);
   const integrations = detectIntegrations(apiDomains);
   const handlerNames = Object.keys(handlers);
-  await writeUsageJson(appDir, { appName, deployedBy, apiUsages });
   if (Object.keys(handlers).length === 0) {
     return { integrations, handlerNames, apiUsages };
   }

package/src/commands/deploy.ts

@@ -15,6 +15,7 @@ import { brokerCredentialProvider, fetchDeployVersion } from '../util/auth/broke
 import { readZthAuth } from '../util/auth/auth-store';
 import { cleanAppName, mfAppName, validateAppName, buildPreviewSlug } from '../util/app-name';
 import { getRemoteUrl, guardCleanTree, pullAndResolve, pushToRemote, initRepo } from '../util/git/repo';
+import { updateOrCreateUsageJson } from '../util/usage-json';
 import { resolveGitEnv } from '../util/git/git-env';
 import { type RemoteType, validateRemoteOptions, resolveRemoteUrl } from '../util/git/remote-options';
 import { setupS3Client } from '../util/s3/client';
@@ -288,6 +289,7 @@ async function deployLive({ paths, consumerName, appName, token, opts }: DeployC
       await guardCleanTree(process.cwd());
       info('syncing with git remote');
       await pullAndResolve(process.cwd(), gitEnv);
+      await updateOrCreateUsageJson(process.cwd(), appName, whoAmI());
     } catch (err) {
       throw tagDeployError('git_error', err);
     }

package/src/util/__tests__/usage-json.test.ts

@@ -0,0 +1,58 @@
+import path from 'node:path';
+import os from 'node:os';
+import { mkdtemp, rm, ensureDir, writeJson, readJson } from 'fs-extra';
+import { execa } from 'execa';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+
+import { updateOrCreateUsageJson } from '../usage-json';
+
+vi.mock('../../backend/handlers', () => ({
+  readHandlers: vi.fn().mockResolvedValue({ handlers: {}, apiDomains: [], apiUsages: { call_snowflake: {} } }),
+}));
+
+describe('updateOrCreateUsageJson', () => {
+  let tmp: string;
+  const usagePath = () => path.join(tmp, 'usage.json');
+  const run = (deployedBy = 'test-user') => updateOrCreateUsageJson(tmp, 'mf-my-app', deployedBy);
+  const commitCount = async () => Number((await execa('git', ['rev-list', '--count', 'HEAD'], { cwd: tmp })).stdout);
+
+  beforeEach(async () => {
+    tmp = await mkdtemp(path.join(os.tmpdir(), 'z2h-usage-'));
+    await execa('git', ['init', '-q'], { cwd: tmp });
+    await execa('git', ['config', 'user.email', 't@t.t'], { cwd: tmp });
+    await execa('git', ['config', 'user.name', 't'], { cwd: tmp });
+    await execa('git', ['commit', '-q', '--allow-empty', '-m', 'init'], { cwd: tmp });
+  });
+
+  afterEach(async () => {
+    await rm(tmp, { recursive: true, force: true });
+  });
+
+  it('creates usage.json from handlers and commits it', async () => {
+    await ensureDir(path.join(tmp, 'backend', 'handlers'));
+    await run();
+    await expect(readJson(usagePath())).resolves.toEqual({
+      appName: 'mf-my-app',
+      deployedBy: 'test-user',
+      apiUsages: { call_snowflake: {} },
+    });
+    expect(await commitCount()).toBe(2);
+  });
+
+  it('merges into existing fields and resets apiUsages when there are no handlers', async () => {
+    await writeJson(usagePath(), { apiUsages: { deleted_handler: {} }, keepMe: 1 });
+    await run();
+    await expect(readJson(usagePath())).resolves.toEqual({
+      keepMe: 1,
+      appName: 'mf-my-app',
+      deployedBy: 'test-user',
+      apiUsages: {},
+    });
+  });
+
+  it('does not commit when nothing changed', async () => {
+    await run();
+    await run();
+    expect(await commitCount()).toBe(2);
+  });
+});

package/src/util/git/repo.ts

@@ -7,7 +7,7 @@ import { DeployError, GitConflictError, messageOf } from '../errors';
 
 type GitEnv = Record<string, string | undefined>;
 
-function execGit(args: string[], dir: string, env?: GitEnv) {
+export function execGit(args: string[], dir: string, env?: GitEnv) {
   return execa('git', args, { cwd: dir, env });
 }
 

package/src/util/usage-json.ts

@@ -0,0 +1,35 @@
+import path from 'node:path';
+import { existsSync } from 'node:fs';
+import { readJson, writeJson } from 'fs-extra';
+import { execa } from 'execa';
+import { readHandlers } from '../backend/handlers';
+import { execGit } from './git/repo';
+
+export function hasHandlers(appDir: string): boolean {
+  return existsSync(path.join(appDir, 'backend', 'handlers'));
+}
+
+/** Other features may add top-level fields, so writes merge into the existing file instead of replacing it. */
+export async function writeUsageJson(appDir: string, patch: Record<string, unknown>): Promise<void> {
+  const file = path.join(appDir, 'usage.json');
+  let existing: Record<string, unknown> = {};
+  try {
+    existing = await readJson(file);
+  } catch (err) {
+    if ((err as { code?: string }).code !== 'ENOENT') {
+      throw err;
+    }
+  }
+  await writeJson(file, { ...existing, ...patch }, { spaces: 2 });
+}
+
+/** Refreshes the git-tracked `usage.json` and commits it if it changed, so a deploy's push carries it. */
+export async function updateOrCreateUsageJson(appDir: string, appName: string, deployedBy: string): Promise<void> {
+  const apiUsages = hasHandlers(appDir) ? (await readHandlers(appDir)).apiUsages : {};
+  await writeUsageJson(appDir, { appName, deployedBy, apiUsages });
+  await execGit(['add', 'usage.json'], appDir);
+  const { exitCode } = await execa('git', ['diff', '--cached', '--quiet'], { cwd: appDir, reject: false });
+  if (exitCode !== 0) {
+    await execGit(['commit', '-m', 'Update usage.json'], appDir);
+  }
+}