@paybond/kit 0.12.0 → 0.12.1

package/dist/cli/commands/dev.js

@@ -11,6 +11,7 @@ import { CliError } from "../types.js";
 import { handleAgentSandboxSmoke } from "./agent.js";
 import { handleLogin } from "./setup.js";
 import { handlePolicyInit, handlePolicyValidateTools } from "./policy.js";
+import { buildShopifyNextStepsBanner } from "./shopify.js";
 import { scheduleCliCommandTelemetry } from "../telemetry.js";
 function devCliError(message, options) {
     return new CliError(message, {
@@ -229,6 +230,10 @@ export async function handleDevLoop(ctx, argv) {
     rest = offlineFlag.rest;
     const policyFlag = consumeFlag(rest, "--policy-file");
     rest = policyFlag.rest;
+    const presetFlag = consumeFlag(rest, "--preset");
+    rest = presetFlag.rest;
+    const shopifyFlag = consumeBooleanFlag(rest, "--shopify");
+    rest = shopifyFlag.rest;
     const noLoginFlag = consumeBooleanFlag(rest, "--no-login");
     rest = noLoginFlag.rest;
     if (rest.length > 0) {
@@ -237,6 +242,7 @@ export async function handleDevLoop(ctx, argv) {
             category: "usage",
         });
     }
+    const preset = presetFlag.value?.trim() || DEV_DEFAULT_PRESET;
     const policyFile = policyFlag.value?.trim() || DEV_DEFAULT_POLICY_FILE;
     const steps = [];
     const bannerLines = buildDevStartupBannerLines();
@@ -279,7 +285,7 @@ export async function handleDevLoop(ctx, argv) {
         }
         const initResult = await handlePolicyInit(activeCtx, [
             "--preset",
-            DEV_DEFAULT_PRESET,
+            preset,
             "--out",
             policyFile,
             "--force",
@@ -303,13 +309,14 @@ export async function handleDevLoop(ctx, argv) {
                 details: { steps },
             });
         }
-        const smokeResult = await runDevSmokeCore(activeCtx, DEV_DEFAULT_PRESET, offlineFlag.present);
+        const smokeResult = await runDevSmokeCore(activeCtx, preset, offlineFlag.present);
         steps.push({ name: "smoke", ok: true, data: smokeResult.data });
         const traceUrl = String(smokeResult.data.trace_url ?? devTraceUrl());
         const auditLog = String(smokeResult.data.audit_log ?? resolve(ctx.cwd, ".paybond/dev-audit.jsonl"));
         const smokeChecklist = Array.isArray(smokeResult.data.checklist_lines)
             ? smokeResult.data.checklist_lines
             : [];
+        const shopifyBanner = shopifyFlag.present ? buildShopifyNextStepsBanner() : [];
         scheduleCliCommandTelemetry(activeCtx, {
             commandPath: "dev loop",
             offline: offlineFlag.present,
@@ -321,7 +328,7 @@ export async function handleDevLoop(ctx, argv) {
                 smoke: smokeResult.data,
                 trace_url: traceUrl,
                 audit_log: auditLog,
-                banner_lines: bannerLines,
+                banner_lines: [...bannerLines, ...shopifyBanner],
                 checklist_lines: appendDevLoopTraceLine(smokeChecklist, traceUrl, ctx.globals),
             },
             warnings: smokeResult.warnings,

package/dist/cli/commands/setup.js

@@ -22,6 +22,7 @@ import { copyTemplateToDirectory, normalizeTemplateId, templateInitUsage, } from
 import { parseArgs as parseLoginArgs, runLogin } from "../../login.js";
 import { main as runMcpServerMain } from "../../mcp-server.js";
 import { PaybondMCPServer } from "../../mcp-server.js";
+import { runShopifyDoctorChecks } from "./shopify.js";
 async function readJsonFile(filePath) {
     return readJsonBody(filePath, process.stdin);
 }
@@ -124,6 +125,19 @@ export async function handleInitWizard(ctx, argv) {
             });
             return { data: result };
         }
+        if (parsed.solution === "shopping" && parsed.framework === "shopify") {
+            const result = await copyTemplateToDirectory({
+                cwd: ctx.cwd,
+                templateId: normalizeTemplateId("shopify-shopping-agent"),
+                force: parsed.force,
+                writeStdout(line) {
+                    if (ctx.globals.format !== "json") {
+                        ctx.stdout.write(`${line}\n`);
+                    }
+                },
+            });
+            return { data: result };
+        }
         const { template: _template, ...wizardOptions } = parsed;
         const result = await runProjectInit({
             cwd: ctx.cwd,
@@ -353,7 +367,8 @@ export async function handleMcpVerifyConfig(ctx, argv) {
 }
 export async function handleDoctor(ctx, argv) {
     const agentFlag = consumeBooleanFlag(argv, "--agent");
-    const hostFlag = consumeFlag(agentFlag.rest, "--host");
+    const shopifyFlag = consumeBooleanFlag(agentFlag.rest, "--shopify");
+    const hostFlag = consumeFlag(shopifyFlag.rest, "--host");
     const checks = [];
     const defaults = resolvedDefaultsForDoctor(ctx.globals);
     checks.push({
@@ -436,6 +451,9 @@ export async function handleDoctor(ctx, argv) {
             });
         }
     }
+    if (shopifyFlag.present) {
+        checks.push(...(await runShopifyDoctorChecks(ctx)));
+    }
     const completionChecks = await runCompletionCatalogDoctorChecks({
         cwd: ctx.cwd,
         gateway: apiKey

package/dist/cli/commands/shopify.d.ts

@@ -0,0 +1,53 @@
+import type { CliContext } from "../context.js";
+import { type CommandResult } from "../types.js";
+export type ShopifyDoctorCheck = {
+    name: string;
+    ok: boolean;
+    message: string;
+    details?: Record<string, unknown>;
+};
+type ExternalCommandResult = {
+    code: number;
+    stdout: string;
+    stderr: string;
+};
+type ShopifyCommandHooks = {
+    whichExecutable?: (name: string) => Promise<string | null>;
+    runCommand?: (command: string, args: string[]) => Promise<ExternalCommandResult>;
+};
+/** Test hook: override external CLI discovery and execution. */
+export declare function setShopifyCommandHooks(hooks: ShopifyCommandHooks): void;
+export type ShopifyAppTomlInfo = {
+    exists: boolean;
+    clientId?: string;
+    path?: string;
+};
+/** Parse `client_id` from a linked `shopify.app.toml` in the working directory. */
+export declare function readShopifyAppToml(cwd: string): Promise<ShopifyAppTomlInfo>;
+export declare function formatShopifyDoctorChecklist(checks: ShopifyDoctorCheck[], useColor: boolean): string[];
+export declare function buildShopifyNextStepsBanner(shopDomain?: string): string[];
+/** Resolve a Paybond gateway origin to the Shopify sandbox webhook path. */
+export declare function resolveShopifyWebhookAddress(gatewayBase: string, tunnel?: string): string;
+export declare function buildShopifyWebhookTriggerCommand(input: {
+    topic: string;
+    address: string;
+    clientId?: string;
+}): string[];
+/** Locate a Paybond Payments `shopify.app.toml` for local dev (cwd or monorepo app path). */
+export declare function readShopifyPaymentsAppToml(cwd: string): Promise<ShopifyAppTomlInfo>;
+export declare function buildShopifyPaymentsNextStepsBanner(shopDomain?: string): string[];
+/** Readiness checks for Paybond + Shopify local development. */
+export declare function runShopifyDoctorChecks(ctx: CliContext): Promise<ShopifyDoctorCheck[]>;
+export declare function handleShopifyDoctor(ctx: CliContext, argv: string[]): Promise<CommandResult>;
+export declare function handleShopifyLink(ctx: CliContext, argv: string[]): Promise<CommandResult>;
+export declare function handleShopifyDev(ctx: CliContext, argv: string[]): Promise<CommandResult>;
+export declare function handleShopifyWebhookTrigger(ctx: CliContext, argv: string[]): Promise<CommandResult>;
+export declare function handleShopifyCheckoutSmoke(ctx: CliContext, argv: string[]): Promise<CommandResult>;
+export declare function handleShopifyOrderShow(ctx: CliContext, argv: string[]): Promise<CommandResult>;
+export declare function handleShopifyCaptureReady(ctx: CliContext, argv: string[]): Promise<CommandResult>;
+export declare function runShopifyPaymentsDoctorChecks(ctx: CliContext): Promise<ShopifyDoctorCheck[]>;
+export declare function handleShopifyPaymentsDoctor(ctx: CliContext, argv: string[]): Promise<CommandResult>;
+export declare function handleShopifyPaymentsSmoke(ctx: CliContext, argv: string[]): Promise<CommandResult>;
+export declare function handleShopifyPaymentsSessionShow(ctx: CliContext, argv: string[]): Promise<CommandResult>;
+export declare function handleShopify(ctx: CliContext, subcommand: string, third: string | undefined, fourth: string | undefined, argv: string[]): Promise<CommandResult>;
+export {};