@solidnumber/cli 2.11.18 → 2.12.0

package/dist/lib/apply/engine.js

@@ -0,0 +1,277 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseManifest = parseManifest;
+exports.extractList = extractList;
+exports.specMatches = specMatches;
+exports.planKind = planKind;
+exports.actionIdempotencyKey = actionIdempotencyKey;
+exports.tallyResults = tallyResults;
+exports.reconcile = reconcile;
+exports.executePlan = executePlan;
+/**
+ * `solid apply` engine — declarative desired-state reconcile.
+ *
+ * Parse a manifest into resources, fetch current state per kind, compute a
+ * plan (create / update / noop / prune), then execute it. The planning core
+ * (parseManifest, specMatches, planKind, extractList) is pure so it's unit
+ * tested without HTTP; executePlan does the writes through a minimal client.
+ */
+const yaml = __importStar(require("js-yaml"));
+const node_crypto_1 = require("node:crypto");
+const registry_1 = require("./registry");
+/**
+ * Parse a manifest string (YAML or JSON) into normalized desired resources.
+ * Accepts: a single resource, a top-level array, `{ resources: [...] }`, and
+ * multi-document YAML. Each resource may be `{ kind, spec }`, k8s-style
+ * `{ kind, metadata, spec }`, or `{ kind, ...fields }` (fields become spec).
+ * `metadata.identity` (or a top-level `identity`) overrides the kind default.
+ */
+function parseManifest(text) {
+    const docs = [];
+    // loadAll handles both single- and multi-document YAML; JSON is valid YAML.
+    yaml.loadAll(text, (d) => { if (d !== null && d !== undefined)
+        docs.push(d); });
+    const raw = [];
+    for (const doc of docs) {
+        if (Array.isArray(doc))
+            raw.push(...doc);
+        else if (doc && typeof doc === 'object' && Array.isArray(doc.resources)) {
+            raw.push(...doc.resources);
+        }
+        else
+            raw.push(doc);
+    }
+    return raw.map((r, i) => normalizeResource(r, i));
+}
+function normalizeResource(r, index) {
+    if (!r || typeof r !== 'object') {
+        throw new Error(`Manifest entry #${index + 1} is not an object`);
+    }
+    const obj = r;
+    const kind = String(obj.kind || '').trim();
+    if (!kind)
+        throw new Error(`Manifest entry #${index + 1} is missing "kind"`);
+    const recon = (0, registry_1.reconcilerFor)(kind);
+    if (!recon) {
+        throw new Error(`Unknown kind "${kind}" (known: see \`solid apply --kinds\`)`);
+    }
+    const metadata = (obj.metadata && typeof obj.metadata === 'object' ? obj.metadata : {});
+    // spec source: explicit `spec`, else all fields except kind/metadata.
+    let spec;
+    if (obj.spec && typeof obj.spec === 'object') {
+        spec = { ...obj.spec };
+    }
+    else {
+        spec = { ...obj };
+        delete spec.kind;
+        delete spec.metadata;
+        delete spec.identity;
+    }
+    const identityField = String(obj.identity || metadata.identity || recon.identity);
+    const identityValue = spec[identityField] ?? metadata.name;
+    if (identityValue === undefined || identityValue === null || identityValue === '') {
+        throw new Error(`${kind} entry #${index + 1} has no identity — set spec.${identityField} (or metadata.name)`);
+    }
+    return { kind, identity: String(identityValue), spec };
+}
+/** Pull the resource array out of a list response, tolerating common shapes. */
+function extractList(resp, recon) {
+    if (Array.isArray(resp))
+        return resp;
+    if (!resp || typeof resp !== 'object')
+        return [];
+    const o = resp;
+    const candidates = [recon.listKey, 'items', 'results', 'data', `${recon.kind}s`].filter(Boolean);
+    for (const key of candidates) {
+        if (Array.isArray(o[key]))
+            return o[key];
+    }
+    return [];
+}
+/**
+ * True when every field declared in `desired` already equals the value on the
+ * current server item (subset semantics — unmanaged server fields are ignored).
+ */
+function specMatches(desired, current) {
+    for (const [k, v] of Object.entries(desired)) {
+        if (!deepEqual(v, current[k]))
+            return false;
+    }
+    return true;
+}
+function deepEqual(a, b) {
+    if (a === b)
+        return true;
+    if (a === null || b === null || typeof a !== typeof b)
+        return false;
+    if (typeof a !== 'object')
+        return false;
+    if (Array.isArray(a) || Array.isArray(b)) {
+        if (!Array.isArray(a) || !Array.isArray(b) || a.length !== b.length)
+            return false;
+        return a.every((x, i) => deepEqual(x, b[i]));
+    }
+    const ao = a;
+    const bo = b;
+    const keys = Object.keys(ao);
+    if (keys.length !== Object.keys(bo).length)
+        return false;
+    return keys.every((k) => deepEqual(ao[k], bo[k]));
+}
+/**
+ * Compute the reconcile plan for one kind. Pure — given the desired resources
+ * and the current server items, returns the ordered list of actions.
+ */
+function planKind(recon, desired, current, opts = {}) {
+    const currentByIdentity = new Map();
+    for (const item of current) {
+        const idv = item[recon.identity];
+        if (idv !== undefined && idv !== null)
+            currentByIdentity.set(String(idv), item);
+    }
+    const actions = [];
+    const seen = new Set();
+    for (const d of desired) {
+        seen.add(d.identity);
+        const existing = currentByIdentity.get(d.identity);
+        if (!existing) {
+            actions.push({ kind: d.kind, identity: d.identity, action: 'create', spec: d.spec });
+            continue;
+        }
+        if (specMatches(d.spec, existing)) {
+            actions.push({ kind: d.kind, identity: d.identity, action: 'noop', id: existing[recon.idField] });
+        }
+        else if (recon.updateMethod === null) {
+            actions.push({
+                kind: d.kind, identity: d.identity, action: 'unsupported',
+                reason: `${d.kind} is immutable — delete and recreate to change`,
+                id: existing[recon.idField],
+            });
+        }
+        else {
+            actions.push({ kind: d.kind, identity: d.identity, action: 'update', id: existing[recon.idField], spec: d.spec });
+        }
+    }
+    if (opts.prune) {
+        for (const [idv, item] of currentByIdentity) {
+            if (!seen.has(idv)) {
+                actions.push({ kind: recon.kind, identity: idv, action: 'prune', id: item[recon.idField] });
+            }
+        }
+    }
+    return actions;
+}
+/** Stable idempotency key for a resource action, derived from its content. */
+function actionIdempotencyKey(a) {
+    const h = (0, node_crypto_1.createHash)('sha256')
+        .update(`${a.action}:${a.kind}:${a.identity}:${JSON.stringify(a.spec ?? {})}`)
+        .digest('hex')
+        .slice(0, 32);
+    return `apply-${h}`;
+}
+/** Count results by action (+ failed) for a summary line. */
+function tallyResults(results) {
+    const c = { create: 0, update: 0, noop: 0, prune: 0, unsupported: 0, failed: 0 };
+    for (const r of results) {
+        if (r.status === 'failed')
+            c.failed++;
+        if (r.action in c)
+            c[r.action]++;
+    }
+    return c;
+}
+/**
+ * Reconcile a set of desired resources end-to-end: group by kind, fetch current
+ * state, plan, execute. Pure orchestration with NO prompting — the interactive
+ * prune confirmation lives in the `apply` command, not here, so this is safe to
+ * call programmatically (the @solidnumber/cli/client facade uses it). Unknown
+ * kinds are skipped (parseManifest already validates when used via the CLI).
+ */
+async function reconcile(client, resources, opts = {}) {
+    const byKind = new Map();
+    for (const r of resources) {
+        const arr = byKind.get(r.kind) ?? [];
+        arr.push(r);
+        byKind.set(r.kind, arr);
+    }
+    const results = [];
+    for (const [kind, desired] of byKind) {
+        const recon = (0, registry_1.reconcilerFor)(kind);
+        if (!recon)
+            continue;
+        const resp = await client.get(recon.list);
+        const current = extractList(resp.data, recon);
+        const actions = planKind(recon, desired, current, { prune: opts.prune });
+        results.push(...(await executePlan(client, recon, actions, !!opts.dryRun)));
+    }
+    return { dryRun: !!opts.dryRun, results, counts: tallyResults(results) };
+}
+/** Execute a plan. `dryRun` returns the plan annotated as skipped, no writes. */
+async function executePlan(client, recon, actions, dryRun) {
+    const results = [];
+    for (const a of actions) {
+        if (a.action === 'noop' || a.action === 'unsupported') {
+            results.push({ ...a, status: 'skipped' });
+            continue;
+        }
+        if (dryRun) {
+            results.push({ ...a, status: 'skipped' });
+            continue;
+        }
+        const key = actionIdempotencyKey(a);
+        const item = recon.itemPath.replace('{id}', String(a.id));
+        try {
+            if (a.action === 'create') {
+                await client.post(recon.create, a.spec, { idempotencyKey: key });
+            }
+            else if (a.action === 'update') {
+                if (recon.updateMethod === 'put')
+                    await client.put(item, a.spec, { idempotencyKey: key });
+                else
+                    await client.patch(item, a.spec, { idempotencyKey: key });
+            }
+            else if (a.action === 'prune') {
+                await client.delete(item, { idempotencyKey: key });
+            }
+            results.push({ ...a, status: 'done' });
+        }
+        catch (e) {
+            results.push({ ...a, status: 'failed', error: e instanceof Error ? e.message : String(e) });
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=engine.js.map

package/dist/lib/apply/engine.js.map

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

package/dist/lib/apply/registry.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Reconciler registry for `solid apply` — maps a declarative manifest `kind`
+ * to the REST shape needed to reconcile it (list current, create, update,
+ * delete one). Adding a kind = one entry here; the engine stays generic.
+ *
+ * Endpoints below are taken verbatim from the matching CLI command files
+ * (commands/products.ts, crm.ts, webhooks.ts, pages.ts, site.ts, domains.ts,
+ * forms.ts / lib/api-client.ts) so they track the real API.
+ * A kind with `updateMethod: null` is immutable (create/delete only) — on
+ * drift the engine reports it rather than silently mutating.
+ */
+export interface Reconciler {
+    /** Manifest `kind` this entry handles. */
+    kind: string;
+    /** Spec field that uniquely identifies a resource within the company. */
+    identity: string;
+    /** GET collection (list current state). */
+    list: string;
+    /** POST collection (create). */
+    create: string;
+    /** Path template for one item; `{id}` is substituted. Used for update/delete. */
+    itemPath: string;
+    /** HTTP verb for an in-place update, or null when the resource is immutable. */
+    updateMethod: 'patch' | 'put' | null;
+    /** Field on a fetched server item that holds its id (default `id`). */
+    idField: string;
+    /** Key in the list response holding the array, when not auto-detectable. */
+    listKey?: string;
+}
+export declare const RECONCILERS: Record<string, Reconciler>;
+export declare function reconcilerFor(kind: string): Reconciler | undefined;
+export declare function knownKinds(): string[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/lib/apply/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/lib/apply/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,WAAW,UAAU;IACzB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,iFAAiF;IACjF,QAAQ,EAAE,MAAM,CAAC;IACjB,gFAAgF;IAChF,YAAY,EAAE,OAAO,GAAG,KAAK,GAAG,IAAI,CAAC;IACrC,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAgFlD,CAAC;AAEF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAElE;AAED,wBAAgB,UAAU,IAAI,MAAM,EAAE,CAErC"}

package/dist/lib/apply/registry.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RECONCILERS = void 0;
+exports.reconcilerFor = reconcilerFor;
+exports.knownKinds = knownKinds;
+exports.RECONCILERS = {
+    product: {
+        kind: 'product',
+        identity: 'sku',
+        list: '/api/v1/products/',
+        create: '/api/v1/products/',
+        itemPath: '/api/v1/products/{id}',
+        updateMethod: 'patch',
+        idField: 'id',
+        listKey: 'products',
+    },
+    contact: {
+        kind: 'contact',
+        identity: 'email',
+        list: '/api/v1/crm/contacts',
+        create: '/api/v1/crm/contacts',
+        itemPath: '/api/v1/crm/contacts/{id}',
+        updateMethod: 'patch',
+        idField: 'id',
+        listKey: 'contacts',
+    },
+    deal: {
+        kind: 'deal',
+        identity: 'name',
+        list: '/api/v1/crm/deals',
+        create: '/api/v1/crm/deals',
+        itemPath: '/api/v1/crm/deals/{id}',
+        updateMethod: 'patch',
+        idField: 'id',
+        listKey: 'deals',
+    },
+    webhook: {
+        kind: 'webhook',
+        identity: 'url',
+        list: '/api/v1/developer/webhooks',
+        create: '/api/v1/developer/webhooks',
+        itemPath: '/api/v1/developer/webhooks/{id}',
+        updateMethod: null, // webhooks are immutable — recreate to change
+        idField: 'id',
+        listKey: 'webhooks',
+    },
+    page: {
+        kind: 'page',
+        identity: 'slug',
+        list: '/api/v1/cms/pages',
+        create: '/api/v1/cms/pages',
+        itemPath: '/api/v1/cms/pages/{id}',
+        updateMethod: 'patch',
+        idField: 'id',
+        listKey: 'pages',
+    },
+    site: {
+        kind: 'site',
+        identity: 'slug',
+        list: '/api/v1/sites',
+        create: '/api/v1/sites',
+        itemPath: '/api/v1/sites/{id}',
+        updateMethod: null, // no in-place site update endpoint — recreate to change
+        idField: 'id',
+        listKey: 'sites',
+    },
+    domain: {
+        kind: 'domain',
+        identity: 'domain',
+        list: '/api/v1/domains/custom', // returns a bare array
+        create: '/api/v1/domains/custom',
+        itemPath: '/api/v1/domains/custom/{id}',
+        updateMethod: null, // domains are verify-then-live — recreate to change
+        idField: 'id',
+    },
+    survey: {
+        kind: 'survey',
+        identity: 'title',
+        list: '/api/v1/surveys',
+        create: '/api/v1/surveys/create',
+        itemPath: '/api/v1/surveys/{id}',
+        updateMethod: 'put',
+        idField: 'id',
+        listKey: 'surveys',
+    },
+};
+function reconcilerFor(kind) {
+    return exports.RECONCILERS[kind] || exports.RECONCILERS[kind.toLowerCase()];
+}
+function knownKinds() {
+    return Object.keys(exports.RECONCILERS).sort();
+}
+//# sourceMappingURL=registry.js.map

package/dist/lib/apply/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/lib/apply/registry.ts"],"names":[],"mappings":";;;AAgHA,sCAEC;AAED,gCAEC;AAxFY,QAAA,WAAW,GAA+B;IACrD,OAAO,EAAE;QACP,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,KAAK;QACf,IAAI,EAAE,mBAAmB;QACzB,MAAM,EAAE,mBAAmB;QAC3B,QAAQ,EAAE,uBAAuB;QACjC,YAAY,EAAE,OAAO;QACrB,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,UAAU;KACpB;IACD,OAAO,EAAE;QACP,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,OAAO;QACjB,IAAI,EAAE,sBAAsB;QAC5B,MAAM,EAAE,sBAAsB;QAC9B,QAAQ,EAAE,2BAA2B;QACrC,YAAY,EAAE,OAAO;QACrB,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,UAAU;KACpB;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,MAAM;QAChB,IAAI,EAAE,mBAAmB;QACzB,MAAM,EAAE,mBAAmB;QAC3B,QAAQ,EAAE,wBAAwB;QAClC,YAAY,EAAE,OAAO;QACrB,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,OAAO;KACjB;IACD,OAAO,EAAE;QACP,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,KAAK;QACf,IAAI,EAAE,4BAA4B;QAClC,MAAM,EAAE,4BAA4B;QACpC,QAAQ,EAAE,iCAAiC;QAC3C,YAAY,EAAE,IAAI,EAAE,8CAA8C;QAClE,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,UAAU;KACpB;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,MAAM;QAChB,IAAI,EAAE,mBAAmB;QACzB,MAAM,EAAE,mBAAmB;QAC3B,QAAQ,EAAE,wBAAwB;QAClC,YAAY,EAAE,OAAO;QACrB,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,OAAO;KACjB;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,MAAM;QAChB,IAAI,EAAE,eAAe;QACrB,MAAM,EAAE,eAAe;QACvB,QAAQ,EAAE,oBAAoB;QAC9B,YAAY,EAAE,IAAI,EAAE,wDAAwD;QAC5E,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,OAAO;KACjB;IACD,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,QAAQ;QAClB,IAAI,EAAE,wBAAwB,EAAE,uBAAuB;QACvD,MAAM,EAAE,wBAAwB;QAChC,QAAQ,EAAE,6BAA6B;QACvC,YAAY,EAAE,IAAI,EAAE,oDAAoD;QACxE,OAAO,EAAE,IAAI;KACd;IACD,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,OAAO;QACjB,IAAI,EAAE,iBAAiB;QACvB,MAAM,EAAE,wBAAwB;QAChC,QAAQ,EAAE,sBAAsB;QAChC,YAAY,EAAE,KAAK;QACnB,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,SAAS;KACnB;CACF,CAAC;AAEF,SAAgB,aAAa,CAAC,IAAY;IACxC,OAAO,mBAAW,CAAC,IAAI,CAAC,IAAI,mBAAW,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;AAC9D,CAAC;AAED,SAAgB,UAAU;IACxB,OAAO,MAAM,CAAC,IAAI,CAAC,mBAAW,CAAC,CAAC,IAAI,EAAE,CAAC;AACzC,CAAC"}

package/dist/lib/commerce-skill.d.ts

@@ -0,0 +1,5 @@
+export declare const COMMERCE_SKILL_DIRNAME = "solid-commerce";
+export declare const COMMERCE_SKILL_CONTENT = "---\nname: solid-commerce\ndescription: Wire generated websites to the Solid# backend \u2014 live contact forms (CRM + lead scoring), AI chat widget, payment-link checkout, declarative publish. Use whenever building or editing a website in this directory.\n---\n\n# Solid# Commerce Wiring\n\nThis directory is bound to a Solid# company (`.solid/manifest.json`). Every\nform, chat bubble, or payment button you generate can be REAL \u2014 backed by the\ncompany's CRM, AI agents, and payment links \u2014 instead of dead markup. Prefer\nwiring to inventing placeholders.\n\n## Contact / lead forms\n\nNever emit a `<form>` that goes nowhere. Wire it to a Solid# lead form \u2014\nsubmissions create CRM contacts, score the lead, and trigger follow-up:\n\n1. Find a form id: `solid forms list` (or the company context shelves).\n2. Emit the snippet: `solid embed form <id>` (add `--react` for a component).\n3. Or hand-wire: POST `{ data: {<fields>}, attribution: {referrer, url} }`\n   to `<api>/api/v1/public/forms/<id>/submit` (public, no auth).\n\n## AI chat widget\n\nOne script tag gives the site a live AI agent trained on this company:\n\n`solid embed chat <integration_id>`   (ids: `solid chat-widgets list`)\n\n## Payments\n\nPayment links render processor-hosted checkout pages \u2014 the site only needs a\nlink. `solid embed paylink <link_id> --label \"Pay deposit\"`. Creating links\nmoves money-adjacent state: the human approves it (typed phrase when asked).\n\n## Publish\n\nDeclarative, one file for the whole surface (pages, site, domain, survey,\nproducts): write `site.yaml`, then\n\n`solid apply site.yaml --dry-run`  \u2192  `solid apply site.yaml`  \u2192  `solid publish --all`\n\nPages go live on the company's subdomain immediately; custom domains need\n`solid domains verify <id>` after DNS is set. Format reference:\n`solid apply --kinds` and Owners-Manual/45-Developer-CLI/APPLY-DECLARATIVE-MANIFESTS.md.\n\n## Rules\n\n- Stay inside this directory \u2014 context and writes are scoped to THIS company.\n- Don't hardcode company ids; the CLI session carries the binding.\n- Financial actions (payment links, charges) always preview first; the human\n  types the approval phrase. Never compose that phrase yourself.\n";
+/** Write the skill into <baseDir>/.claude/skills/solid-commerce/SKILL.md. */
+export declare function installCommerceSkill(baseDir: string): string;
+//# sourceMappingURL=commerce-skill.d.ts.map

package/dist/lib/commerce-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commerce-skill.d.ts","sourceRoot":"","sources":["../../src/lib/commerce-skill.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,sBAAsB,mBAAmB,CAAC;AAEvD,eAAO,MAAM,sBAAsB,ysEAmDlC,CAAC;AAEF,6EAA6E;AAC7E,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAM5D"}

package/dist/lib/commerce-skill.js

@@ -0,0 +1,111 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COMMERCE_SKILL_CONTENT = exports.COMMERCE_SKILL_DIRNAME = void 0;
+exports.installCommerceSkill = installCommerceSkill;
+/**
+ * The solid-commerce Claude Code skill — installed into a tenant-bound
+ * directory's `.claude/skills/` by `solid context --claude` (both ladder and
+ * legacy-full modes). Teaches a coding agent to wire the sites it generates
+ * to the company's REAL backend instead of emitting dead markup.
+ *
+ * Role-2 boundary: callers reach this only after requireTenantManifest /
+ * tenantManifestForHook has passed, so the skill can never land in $HOME or
+ * the platform monorepo (CLAUDE-CONTEXT-CANONICAL-TRUTH.md).
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+exports.COMMERCE_SKILL_DIRNAME = 'solid-commerce';
+exports.COMMERCE_SKILL_CONTENT = `---
+name: solid-commerce
+description: Wire generated websites to the Solid# backend — live contact forms (CRM + lead scoring), AI chat widget, payment-link checkout, declarative publish. Use whenever building or editing a website in this directory.
+---
+
+# Solid# Commerce Wiring
+
+This directory is bound to a Solid# company (\`.solid/manifest.json\`). Every
+form, chat bubble, or payment button you generate can be REAL — backed by the
+company's CRM, AI agents, and payment links — instead of dead markup. Prefer
+wiring to inventing placeholders.
+
+## Contact / lead forms
+
+Never emit a \`<form>\` that goes nowhere. Wire it to a Solid# lead form —
+submissions create CRM contacts, score the lead, and trigger follow-up:
+
+1. Find a form id: \`solid forms list\` (or the company context shelves).
+2. Emit the snippet: \`solid embed form <id>\` (add \`--react\` for a component).
+3. Or hand-wire: POST \`{ data: {<fields>}, attribution: {referrer, url} }\`
+   to \`<api>/api/v1/public/forms/<id>/submit\` (public, no auth).
+
+## AI chat widget
+
+One script tag gives the site a live AI agent trained on this company:
+
+\`solid embed chat <integration_id>\`   (ids: \`solid chat-widgets list\`)
+
+## Payments
+
+Payment links render processor-hosted checkout pages — the site only needs a
+link. \`solid embed paylink <link_id> --label "Pay deposit"\`. Creating links
+moves money-adjacent state: the human approves it (typed phrase when asked).
+
+## Publish
+
+Declarative, one file for the whole surface (pages, site, domain, survey,
+products): write \`site.yaml\`, then
+
+\`solid apply site.yaml --dry-run\`  →  \`solid apply site.yaml\`  →  \`solid publish --all\`
+
+Pages go live on the company's subdomain immediately; custom domains need
+\`solid domains verify <id>\` after DNS is set. Format reference:
+\`solid apply --kinds\` and Owners-Manual/45-Developer-CLI/APPLY-DECLARATIVE-MANIFESTS.md.
+
+## Rules
+
+- Stay inside this directory — context and writes are scoped to THIS company.
+- Don't hardcode company ids; the CLI session carries the binding.
+- Financial actions (payment links, charges) always preview first; the human
+  types the approval phrase. Never compose that phrase yourself.
+`;
+/** Write the skill into <baseDir>/.claude/skills/solid-commerce/SKILL.md. */
+function installCommerceSkill(baseDir) {
+    const skillDir = path.join(baseDir, '.claude', 'skills', exports.COMMERCE_SKILL_DIRNAME);
+    fs.mkdirSync(skillDir, { recursive: true });
+    const skillPath = path.join(skillDir, 'SKILL.md');
+    fs.writeFileSync(skillPath, exports.COMMERCE_SKILL_CONTENT);
+    return skillPath;
+}
+//# sourceMappingURL=commerce-skill.js.map

package/dist/lib/commerce-skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commerce-skill.js","sourceRoot":"","sources":["../../src/lib/commerce-skill.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqEA,oDAMC;AA3ED;;;;;;;;;GASG;AACH,uCAAyB;AACzB,2CAA6B;AAEhB,QAAA,sBAAsB,GAAG,gBAAgB,CAAC;AAE1C,QAAA,sBAAsB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmDrC,CAAC;AAEF,6EAA6E;AAC7E,SAAgB,oBAAoB,CAAC,OAAe;IAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,8BAAsB,CAAC,CAAC;IACjF,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAClD,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,8BAAsB,CAAC,CAAC;IACpD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/lib/embed-snippets.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Embed snippet builders — pure string generation for `solid embed`.
+ *
+ * Each builder emits ready-to-paste markup that points an external (often
+ * AI-generated) website at the real Solid# backend: the chat widget script,
+ * a lead form wired to the public submit endpoint (contact + lead score +
+ * drip on submit), and a payment-link button. No HTTP here — the command
+ * fetches whatever live data a snippet needs and passes it in, so these are
+ * unit-testable and usable from the programmatic client.
+ */
+export interface FormField {
+    name: string;
+    label?: string;
+    type?: string;
+    required?: boolean;
+    options?: string[];
+}
+export interface FormConfig {
+    id: number;
+    title?: string;
+    subtitle?: string;
+    fields?: FormField[];
+    submit_button_text?: string;
+}
+/** Chat widget — one script tag, config resolves server-side by integration id. */
+export declare function chatEmbedSnippet(apiBase: string, integrationId: string | number): string;
+/**
+ * Lead form — plain HTML + vanilla JS POSTing `{ data, attribution }` to the
+ * public submit endpoint. Submissions create/score CRM contacts server-side.
+ */
+export declare function formEmbedSnippet(apiBase: string, form: FormConfig): string;
+/** React flavor of the lead form — drop into any Next.js / React site. */
+export declare function formEmbedSnippetReact(apiBase: string, form: FormConfig): string;
+/** Payment link — checkout happens on the processor-hosted page. */
+export declare function paylinkEmbedSnippet(checkoutUrl: string, label?: string): string;
+//# sourceMappingURL=embed-snippets.d.ts.map

package/dist/lib/embed-snippets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed-snippets.d.ts","sourceRoot":"","sources":["../../src/lib/embed-snippets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAYD,mFAAmF;AACnF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAGxF;AAcD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAwC1E;AAED,0EAA0E;AAC1E,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CA8C/E;AAED,oEAAoE;AACpE,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,MAAM,CAElF"}