@percher/core 0.4.10 → 0.4.12

package/dist/ai-files-manifest.d.ts

@@ -1,4 +1,4 @@
-import type { AiFileTemplate } from "./templates/ai-files";
+import type { AiFileTemplate } from "./templates/ai-files/index.js";
 export interface ManifestEntry {
     templateId: string;
     templateVersion: string;

package/dist/appstore-artifacts.d.ts

@@ -0,0 +1,44 @@
+export declare function themeColorForToken(token: string | null): string;
+/**
+ * Minimal VALID manifest.json starter. It is a file the user downloads and
+ * serves verbatim, so it must parse — no JS comments. Icons are intentionally
+ * omitted (we can't generate the user's artwork). `theme_color` is the app's
+ * accent token (brand green by default); `background_color` stays a neutral
+ * white. start_url is "/" (served from the app's own origin).
+ */
+export declare function manifestStarter({ name, themeColorHex, }: {
+    name: string;
+    themeColorHex: string;
+}): string;
+/** Minimal offline-shell service worker (caches the app shell on install). */
+export declare function serviceWorkerStarter(): string;
+/** The one-line registration snippet to add to the app's entry HTML/JS. */
+export declare function swRegistrationSnippet(): string;
+/** Pre-filled Bubblewrap init/build, pointed at the app's manifest. */
+export declare function bubblewrapCommand({ url }: {
+    url: string;
+}): string;
+/** capacitor.config.ts pointed at the app's URL. */
+export declare function capacitorConfig({ name, url }: {
+    name: string;
+    url: string;
+}): string;
+/**
+ * Digital Asset Links (assetlinks.json) for a Trusted Web Activity. Inputs
+ * come from a form — package name + signing-cert SHA-256 don't exist until the
+ * user creates and signs the Android app, so empty inputs keep placeholders.
+ */
+export declare function assetlinksJson({ packageName, sha256Fingerprint, }: {
+    packageName: string;
+    sha256Fingerprint: string;
+}): string;
+/**
+ * Apple App Site Association (AASA) for iOS universal links. Form inputs;
+ * empty Team ID / bundle ID keep placeholders. Served with NO extension as
+ * application/json on the app's origin.
+ */
+export declare function appleAppSiteAssociation({ teamId, bundleId, }: {
+    teamId: string;
+    bundleId: string;
+}): string;
+//# sourceMappingURL=appstore-artifacts.d.ts.map

package/dist/appstore-artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appstore-artifacts.d.ts","sourceRoot":"","sources":["../src/appstore-artifacts.ts"],"names":[],"mappings":"AAwBA,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAG/D;AAiBD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,EAC9B,IAAI,EACJ,aAAa,GACd,EAAE;IACD,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,MAAM,CAaT;AAED,8EAA8E;AAC9E,wBAAgB,oBAAoB,IAAI,MAAM,CAyB7C;AAED,2EAA2E;AAC3E,wBAAgB,qBAAqB,IAAI,MAAM,CAI9C;AAED,uEAAuE;AACvE,wBAAgB,iBAAiB,CAAC,EAAE,GAAG,EAAE,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAKlE;AAED,oDAAoD;AACpD,wBAAgB,eAAe,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAUpF;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAC7B,WAAW,EACX,iBAAiB,GAClB,EAAE;IACD,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,GAAG,MAAM,CAWT;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,MAAM,EACN,QAAQ,GACT,EAAE;IACD,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,MAAM,CAST"}

package/dist/appstore-artifacts.js

@@ -0,0 +1,142 @@
+// App-store kit generators (FUTURE_app-store-publishing-bridge).
+//
+// Pure, dependency-free functions that emit *starter* artifacts for taking a
+// Percher-hosted app to the app stores. Shared by the dashboard "App store kit"
+// panel (C2), the CLI `percher appstore-kit`, and the MCP `percher_appstore_kit`
+// tool (D) so all three stay byte-identical. They also track the templates in
+// the docs section app/docs/sections/app-stores.tsx — keep them in step.
+//
+// None of these make the app a PWA or publish it anywhere; they produce files
+// the user still has to wire up + serve (or let Percher edge-serve, C3).
+const BRAND_GREEN = "#2d6a4f";
+// Maps the owner-picked iconColour token to a literal brand hex for the
+// manifest's theme_color/background. A manifest is a downloadable file, so it
+// needs a real hex — not a CSS var. Defaults to brand green when null/unknown.
+const ICON_COLOUR_HEX = {
+    green: BRAND_GREEN,
+    terracotta: "#d0653a",
+    blue: "#4a6fa4",
+    purple: "#6e4dba",
+    olive: "#b8923a",
+};
+export function themeColorForToken(token) {
+    if (token && token in ICON_COLOUR_HEX)
+        return ICON_COLOUR_HEX[token] ?? BRAND_GREEN;
+    return BRAND_GREEN;
+}
+/** Best-effort hostname from an app URL; falls back to the raw input. */
+function hostFromUrl(url) {
+    try {
+        return new URL(url).host;
+    }
+    catch {
+        return url.replace(/^https?:\/\//, "").replace(/\/.*$/, "");
+    }
+}
+/** A short_name derived from the app name — letters/digits only, capped at 12. */
+function shortName(name) {
+    const cleaned = name.replace(/[^A-Za-z0-9]/g, "");
+    return (cleaned || "App").slice(0, 12);
+}
+/**
+ * Minimal VALID manifest.json starter. It is a file the user downloads and
+ * serves verbatim, so it must parse — no JS comments. Icons are intentionally
+ * omitted (we can't generate the user's artwork). `theme_color` is the app's
+ * accent token (brand green by default); `background_color` stays a neutral
+ * white. start_url is "/" (served from the app's own origin).
+ */
+export function manifestStarter({ name, themeColorHex, }) {
+    return JSON.stringify({
+        name,
+        short_name: shortName(name),
+        start_url: "/",
+        display: "standalone",
+        background_color: "#ffffff",
+        theme_color: themeColorHex,
+    }, null, 2);
+}
+/** Minimal offline-shell service worker (caches the app shell on install). */
+export function serviceWorkerStarter() {
+    return `// sw.js — minimal offline shell. Drop in at your app root and serve from /sw.js.
+const CACHE = "app-shell-v1";
+const SHELL = ["/"];
+
+self.addEventListener("install", (event) => {
+  event.waitUntil(caches.open(CACHE).then((cache) => cache.addAll(SHELL)));
+  self.skipWaiting();
+});
+
+self.addEventListener("activate", (event) => {
+  event.waitUntil(
+    caches.keys().then((keys) =>
+      Promise.all(keys.filter((k) => k !== CACHE).map((k) => caches.delete(k))),
+    ),
+  );
+  self.clients.claim();
+});
+
+self.addEventListener("fetch", (event) => {
+  if (event.request.method !== "GET") return;
+  event.respondWith(
+    caches.match(event.request).then((cached) => cached || fetch(event.request)),
+  );
+});`;
+}
+/** The one-line registration snippet to add to the app's entry HTML/JS. */
+export function swRegistrationSnippet() {
+    return `if ("serviceWorker" in navigator) {
+  navigator.serviceWorker.register("/sw.js");
+}`;
+}
+/** Pre-filled Bubblewrap init/build, pointed at the app's manifest. */
+export function bubblewrapCommand({ url }) {
+    const host = hostFromUrl(url);
+    return `# generate the Android project, pointed at your manifest
+npx @bubblewrap/cli init --manifest https://${host}/manifest.json
+npx @bubblewrap/cli build`;
+}
+/** capacitor.config.ts pointed at the app's URL. */
+export function capacitorConfig({ name, url }) {
+    const host = hostFromUrl(url);
+    return `import type { CapacitorConfig } from "@capacitor/cli";
+const config: CapacitorConfig = {
+  appId: "app.percher.yourapp",
+  appName: ${JSON.stringify(name)},
+  webDir: "dist",
+  server: { url: "https://${host}", cleartext: false },
+};
+export default config;`;
+}
+/**
+ * Digital Asset Links (assetlinks.json) for a Trusted Web Activity. Inputs
+ * come from a form — package name + signing-cert SHA-256 don't exist until the
+ * user creates and signs the Android app, so empty inputs keep placeholders.
+ */
+export function assetlinksJson({ packageName, sha256Fingerprint, }) {
+    const pkg = packageName.trim() || "app.percher.yourapp";
+    const fp = sha256Fingerprint.trim() || "<your signing cert SHA-256>";
+    return `[{
+  "relation": ["delegate_permission/common.handle_all_urls"],
+  "target": {
+    "namespace": "android_app",
+    "package_name": ${JSON.stringify(pkg)},
+    "sha256_cert_fingerprints": [${JSON.stringify(fp)}]
+  }
+}]`;
+}
+/**
+ * Apple App Site Association (AASA) for iOS universal links. Form inputs;
+ * empty Team ID / bundle ID keep placeholders. Served with NO extension as
+ * application/json on the app's origin.
+ */
+export function appleAppSiteAssociation({ teamId, bundleId, }) {
+    const team = teamId.trim() || "TEAMID";
+    const bundle = bundleId.trim() || "app.percher.yourapp";
+    return `{
+  "applinks": {
+    "apps": [],
+    "details": [{ "appID": ${JSON.stringify(`${team}.${bundle}`)}, "paths": ["*"] }]
+  }
+}`;
+}
+//# sourceMappingURL=appstore-artifacts.js.map

package/dist/appstore-artifacts.js.map

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

package/dist/commands/account.d.ts

@@ -1,6 +1,6 @@
 import type { DeletionPreview } from "@percher/client";
 import { z } from "zod";
-import type { Context } from "../context";
+import type { Context } from "../context.js";
 /**
  * IMPLEMENTING-followup item 7 — GDPR account commands. The server
  * already exposes GET /account/export (Art. 20) and DELETE /account

package/dist/commands/account.js

@@ -1,8 +1,8 @@
 import { mkdir, writeFile } from "node:fs/promises";
 import { join, resolve } from "node:path";
 import { z } from "zod";
-import { PercherCoreError } from "../errors";
-import { writeResponseToFile } from "../stream-utils";
+import { PercherCoreError } from "../errors.js";
+import { writeResponseToFile } from "../stream-utils.js";
 /**
  * IMPLEMENTING-followup item 7 — GDPR account commands. The server
  * already exposes GET /account/export (Art. 20) and DELETE /account

package/dist/commands/admin-reconcile-routes.d.ts

@@ -1,6 +1,6 @@
 import type { AdminReconcileRoutesResult } from "@percher/client";
 import { z } from "zod";
-import type { Context } from "../context";
+import type { Context } from "../context.js";
 /**
  * FUTURE18 Fas 4 — `percher admin reconcile-routes` command. Thin
  * wrapper around the client's `adminReconcileRoutes` so the CLI,

package/dist/commands/ai-files.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod";
-import { type FileStatus } from "../ai-files-manifest";
-import type { Context } from "../context";
+import { type FileStatus } from "../ai-files-manifest.js";
+import type { Context } from "../context.js";
 export declare const aiFilesInstallInputSchema: z.ZodObject<{
     force: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;

package/dist/commands/ai-files.js

@@ -1,8 +1,8 @@
 import { mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { z } from "zod";
-import { classifyFile, hashContent, hasSymlinkInPath, loadManifest, saveManifest, } from "../ai-files-manifest";
-import { AI_FILE_TEMPLATES } from "../templates/ai-files";
+import { classifyFile, hashContent, hasSymlinkInPath, loadManifest, saveManifest, } from "../ai-files-manifest.js";
+import { AI_FILE_TEMPLATES } from "../templates/ai-files/index.js";
 export const aiFilesInstallInputSchema = z.object({
     force: z.boolean().optional(),
 });

package/dist/commands/alerts.d.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import type { Context } from "../context";
+import type { Context } from "../context.js";
 /**
  * FUTURE9 Fas 3 — MCP tools that wrap `/alerts/preferences`.
  *

package/dist/commands/app-resources.d.ts

@@ -1,6 +1,6 @@
 import type { AppResources } from "@percher/client";
 import { z } from "zod";
-import type { Context } from "../context";
+import type { Context } from "../context.js";
 export declare const appResourcesInputSchema: z.ZodObject<{
     app: z.ZodOptional<z.ZodString>;
     window: z.ZodOptional<z.ZodEnum<{

package/dist/commands/app-resources.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
-import { readPercherTomlAppName } from "../app-name";
-import { PercherCoreError } from "../errors";
+import { readPercherTomlAppName } from "../app-name.js";
+import { PercherCoreError } from "../errors.js";
 export const appResourcesInputSchema = z.object({
     app: z.string().optional(),
     window: z.enum(["1h", "24h", "7d", "30d"]).optional(),

package/dist/commands/app-topology.d.ts

@@ -1,6 +1,6 @@
 import type { AppTopology } from "@percher/client";
 import { z } from "zod";
-import type { Context } from "../context";
+import type { Context } from "../context.js";
 export declare const appTopologyInputSchema: z.ZodObject<{
     app: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;

package/dist/commands/app-topology.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
-import { readPercherTomlAppName } from "../app-name";
-import { PercherCoreError } from "../errors";
+import { readPercherTomlAppName } from "../app-name.js";
+import { PercherCoreError } from "../errors.js";
 export const appTopologyInputSchema = z.object({
     app: z.string().optional(),
 });

package/dist/commands/appstore-kit.d.ts

@@ -0,0 +1,36 @@
+import { z } from "zod";
+import type { Context } from "../context.js";
+/**
+ * FUTURE_app-store-publishing-bridge D — emit the app-store starter artifacts
+ * from the terminal / an AI assistant, the CLI+MCP parity for the dashboard's
+ * "App store kit" panel (C2). Writes manifest.json, sw.js, capacitor.config.ts,
+ * and `.well-known/{assetlinks.json,apple-app-site-association}` templates into
+ * the project, and returns the Bubblewrap command + SW registration snippet to
+ * print. Pure local file emission — no network, no auth. Existing files are
+ * skipped unless `force`.
+ */
+export declare const appstoreKitInputSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    packageName: z.ZodOptional<z.ZodString>;
+    fingerprint: z.ZodOptional<z.ZodString>;
+    teamId: z.ZodOptional<z.ZodString>;
+    bundleId: z.ZodOptional<z.ZodString>;
+    force: z.ZodOptional<z.ZodBoolean>;
+    outDir: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type AppstoreKitInput = z.infer<typeof appstoreKitInputSchema>;
+export interface AppstoreKitResult {
+    appName: string;
+    appUrl: string;
+    /** Project-relative paths actually written. */
+    written: string[];
+    /** Project-relative paths skipped because they exist and force was not set. */
+    skipped: string[];
+    /** The Bubblewrap init/build command, pointed at the app's manifest. */
+    bubblewrapCommand: string;
+    /** The one-line service-worker registration snippet for the app's entry. */
+    swRegistration: string;
+}
+export declare function appstoreKit(ctx: Context, input?: AppstoreKitInput): Promise<AppstoreKitResult>;
+//# sourceMappingURL=appstore-kit.d.ts.map

package/dist/commands/appstore-kit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appstore-kit.d.ts","sourceRoot":"","sources":["../../src/commands/appstore-kit.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAG1C;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;iBAiBjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,+EAA+E;IAC/E,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,wEAAwE;IACxE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,4EAA4E;IAC5E,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wBAAsB,WAAW,CAC/B,GAAG,EAAE,OAAO,EACZ,KAAK,GAAE,gBAAqB,GAC3B,OAAO,CAAC,iBAAiB,CAAC,CA8D5B"}

package/dist/commands/appstore-kit.js

@@ -0,0 +1,93 @@
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
+import { z } from "zod";
+import { readPercherTomlAppName } from "../app-name.js";
+import { appleAppSiteAssociation, assetlinksJson, bubblewrapCommand, capacitorConfig, manifestStarter, serviceWorkerStarter, swRegistrationSnippet, themeColorForToken, } from "../appstore-artifacts.js";
+import { PercherCoreError } from "../errors.js";
+/**
+ * FUTURE_app-store-publishing-bridge D — emit the app-store starter artifacts
+ * from the terminal / an AI assistant, the CLI+MCP parity for the dashboard's
+ * "App store kit" panel (C2). Writes manifest.json, sw.js, capacitor.config.ts,
+ * and `.well-known/{assetlinks.json,apple-app-site-association}` templates into
+ * the project, and returns the Bubblewrap command + SW registration snippet to
+ * print. Pure local file emission — no network, no auth. Existing files are
+ * skipped unless `force`.
+ */
+export const appstoreKitInputSchema = z.object({
+    /** App name (defaults to percher.toml's [app].name, then the directory name). */
+    name: z.string().optional(),
+    /** App URL (defaults to https://<name>.percher.run). */
+    url: z.string().optional(),
+    /** Android package name for assetlinks.json (placeholder if omitted). */
+    packageName: z.string().optional(),
+    /** Signing-cert SHA-256 fingerprint for assetlinks.json (placeholder if omitted). */
+    fingerprint: z.string().optional(),
+    /** Apple Team ID for apple-app-site-association (placeholder if omitted). */
+    teamId: z.string().optional(),
+    /** Apple bundle ID for apple-app-site-association (placeholder if omitted). */
+    bundleId: z.string().optional(),
+    /** Overwrite files that already exist (default: skip them). */
+    force: z.boolean().optional(),
+    /** Output directory, relative to the project root (default: "."). */
+    outDir: z.string().optional(),
+});
+export async function appstoreKit(ctx, input = {}) {
+    const name = (input.name ?? readPercherTomlAppName(ctx.cwd) ?? basename(ctx.cwd) ?? "app").trim() || "app";
+    const url = input.url?.trim() || `https://${name}.percher.run`;
+    const themeHex = themeColorForToken(null);
+    const base = resolve(ctx.cwd, input.outDir ?? ".");
+    // The schema says outDir is project-relative and the tool writes "into the
+    // project" — reject an absolute path or a `..` escape so a stray --out can't
+    // create/overwrite files outside the project (especially with --force).
+    const baseRel = relative(ctx.cwd, base);
+    if (baseRel.startsWith("..") || isAbsolute(baseRel)) {
+        throw new PercherCoreError("Output directory must stay inside the project", {
+            code: "appstore-kit.bad-out-dir",
+            hint: "Pass a path inside the current project (e.g. --out public), not an absolute or parent path.",
+        });
+    }
+    // Posix-style relative paths for display; split on "/" to build the OS path.
+    const files = [
+        { rel: "manifest.json", content: manifestStarter({ name, themeColorHex: themeHex }) },
+        { rel: "sw.js", content: serviceWorkerStarter() },
+        { rel: "capacitor.config.ts", content: capacitorConfig({ name, url }) },
+        {
+            rel: ".well-known/assetlinks.json",
+            content: assetlinksJson({
+                packageName: input.packageName ?? "",
+                sha256Fingerprint: input.fingerprint ?? "",
+            }),
+        },
+        {
+            rel: ".well-known/apple-app-site-association",
+            content: appleAppSiteAssociation({
+                teamId: input.teamId ?? "",
+                bundleId: input.bundleId ?? "",
+            }),
+        },
+    ];
+    const written = [];
+    const skipped = [];
+    for (const f of files) {
+        const abs = join(base, ...f.rel.split("/"));
+        // Report the true project-relative path (includes outDir) so CLI/MCP output
+        // points at where the file actually landed, e.g. `public/manifest.json`.
+        const display = relative(ctx.cwd, abs).split(sep).join("/");
+        if (existsSync(abs) && !input.force) {
+            skipped.push(display);
+            continue;
+        }
+        mkdirSync(dirname(abs), { recursive: true });
+        writeFileSync(abs, `${f.content}\n`, "utf8");
+        written.push(display);
+    }
+    return {
+        appName: name,
+        appUrl: url,
+        written,
+        skipped,
+        bubblewrapCommand: bubblewrapCommand({ url }),
+        swRegistration: swRegistrationSnippet(),
+    };
+}
+//# sourceMappingURL=appstore-kit.js.map

package/dist/commands/appstore-kit.js.map

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

package/dist/commands/billing.d.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import type { Context } from "../context";
+import type { Context } from "../context.js";
 export declare const billingUpgradeInputSchema: z.ZodObject<{
     plan: z.ZodEnum<{
         starter: "starter";

package/dist/commands/billing.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { PercherCoreError } from "../errors";
+import { PercherCoreError } from "../errors.js";
 export const billingUpgradeInputSchema = z.object({
     plan: z.enum(["starter", "maker", "pro"]),
 });

package/dist/commands/cache.d.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import type { Context } from "../context";
+import type { Context } from "../context.js";
 export declare const cacheResetInputSchema: z.ZodObject<{
     app: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;

package/dist/commands/cache.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
-import { readPercherTomlAppName } from "../app-name";
-import { PercherCoreError } from "../errors";
+import { readPercherTomlAppName } from "../app-name.js";
+import { PercherCoreError } from "../errors.js";
 export const cacheResetInputSchema = z.object({
     app: z.string().optional(),
 });

package/dist/commands/capabilities.d.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import type { Context } from "../context";
+import type { Context } from "../context.js";
 export declare const capabilitiesInputSchema: z.ZodObject<{}, z.core.$strip>;
 export type CapabilitiesInput = z.infer<typeof capabilitiesInputSchema>;
 /** Discovery: platform features + account plan, limits and usage. */

package/dist/commands/claim.d.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import type { Context } from "../context";
+import type { Context } from "../context.js";
 export declare const claimInputSchema: z.ZodObject<{
     app: z.ZodOptional<z.ZodString>;
     claimToken: z.ZodOptional<z.ZodString>;

package/dist/commands/claim.js

@@ -1,6 +1,6 @@
 import { clearAnonClaim, getAnonClaim, listAnonClaimApps } from "@percher/client";
 import { z } from "zod";
-import { readPercherTomlAppName } from "../app-name";
+import { readPercherTomlAppName } from "../app-name.js";
 export const claimInputSchema = z.object({
     app: z
         .string()

package/dist/commands/create.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod";
-import type { Context } from "../context";
-import { type ScaffoldResult } from "../templates";
+import type { Context } from "../context.js";
+import { type ScaffoldResult } from "../templates.js";
 export declare const createInputSchema: z.ZodObject<{
     name: z.ZodString;
     template: z.ZodString;

package/dist/commands/create.js

@@ -1,8 +1,8 @@
 import { join, resolve } from "node:path";
 import { APP_NAME_RE } from "@percher/shared";
 import { z } from "zod";
-import { PercherCoreError } from "../errors";
-import { listTemplates, scaffoldTemplate } from "../templates";
+import { PercherCoreError } from "../errors.js";
+import { listTemplates, scaffoldTemplate } from "../templates.js";
 export const createInputSchema = z.object({
     name: z
         .string()

package/dist/commands/dashboard.d.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import type { Context } from "../context";
+import type { Context } from "../context.js";
 export declare const dashboardInputSchema: z.ZodObject<{
     app: z.ZodOptional<z.ZodString>;
     tab: z.ZodOptional<z.ZodString>;

package/dist/commands/dashboard.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
-import { readPercherTomlAppName } from "../app-name";
-import { PercherCoreError } from "../errors";
+import { readPercherTomlAppName } from "../app-name.js";
+import { PercherCoreError } from "../errors.js";
 export const dashboardInputSchema = z.object({
     app: z.string().optional(),
     tab: z.string().optional(),

package/dist/commands/data-export.d.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import type { Context } from "../context";
+import type { Context } from "../context.js";
 export declare const dataExportInputSchema: z.ZodObject<{
     app: z.ZodOptional<z.ZodString>;
     out: z.ZodOptional<z.ZodString>;

package/dist/commands/data-export.js

@@ -1,8 +1,8 @@
 import { resolve } from "node:path";
 import { z } from "zod";
-import { readPercherTomlAppName } from "../app-name";
-import { PercherCoreError } from "../errors";
-import { writeResponseToFile } from "../stream-utils";
+import { readPercherTomlAppName } from "../app-name.js";
+import { PercherCoreError } from "../errors.js";
+import { writeResponseToFile } from "../stream-utils.js";
 export const dataExportInputSchema = z.object({
     app: z.string().optional().describe("App name or id. Defaults to the app in percher.toml."),
     out: z

package/dist/commands/data.d.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import type { Context } from "../context";
+import type { Context } from "../context.js";
 export declare const dataInputSchema: z.ZodObject<{
     app: z.ZodOptional<z.ZodString>;
     json: z.ZodOptional<z.ZodBoolean>;

package/dist/commands/data.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
-import { readPercherTomlAppName } from "../app-name";
-import { PercherCoreError } from "../errors";
+import { readPercherTomlAppName } from "../app-name.js";
+import { PercherCoreError } from "../errors.js";
 export const dataInputSchema = z.object({
     app: z.string().optional(),
     json: z.boolean().optional(),

package/dist/commands/delete.d.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import type { Context } from "../context";
+import type { Context } from "../context.js";
 export declare const deleteInputSchema: z.ZodObject<{
     app: z.ZodOptional<z.ZodString>;
     confirm: z.ZodBoolean;

package/dist/commands/delete.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
-import { readPercherTomlAppName } from "../app-name";
-import { PercherCoreError } from "../errors";
+import { readPercherTomlAppName } from "../app-name.js";
+import { PercherCoreError } from "../errors.js";
 export const deleteInputSchema = z.object({
     app: z.string().optional().describe("App name to delete (defaults to percher.toml app name)"),
     confirm: z

package/dist/commands/deploys.d.ts

@@ -1,6 +1,6 @@
 import { type Deployment } from "@percher/client";
 import { z } from "zod";
-import type { Context } from "../context";
+import type { Context } from "../context.js";
 export declare const deploysListInputSchema: z.ZodObject<{
     app: z.ZodOptional<z.ZodString>;
     limit: z.ZodOptional<z.ZodNumber>;

package/dist/commands/deploys.js

@@ -1,7 +1,7 @@
 import { PercherApiError } from "@percher/client";
 import { z } from "zod";
-import { readPercherTomlAppName } from "../app-name";
-import { PercherCoreError } from "../errors";
+import { readPercherTomlAppName } from "../app-name.js";
+import { PercherCoreError } from "../errors.js";
 export const deploysListInputSchema = z.object({
     app: z.string().optional(),
     limit: z.number().int().positive().max(100).optional(),

package/dist/commands/dev.d.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import type { Context } from "../context";
+import type { Context } from "../context.js";
 export declare const devInputSchema: z.ZodObject<{
     app: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;