@adminiumjs/add-on-contracts 0.2.1

package/dist/slots.js

@@ -0,0 +1,124 @@
+/**
+ * Slot registry v1 — CLOSED (24-marketplace-wave-4.md §5.4, eleven slots).
+ *
+ * A slot is a named place in a host surface, its payload, and its fill rule.
+ * The registry is closed for the same reason the widget-id vocabulary is: an
+ * open-ended extension point cannot be reviewed, translated, or kept working
+ * across host versions. Adding a slot is a spec change with a version bump on
+ * this package — never a pull request against an app.
+ *
+ * Every slot here is filled by something built in wave 4. A slot nobody fills
+ * is a guess about a future add-on, which is why an earlier draft's twelfth
+ * (`job.timeline.entries`) is absent.
+ */
+import { z } from 'zod';
+/** Which persona's surface the slot lives in. */
+export const SLOT_SURFACES = ['customer', 'staff', 'admin', 'both'];
+/**
+ * `multi` renders every enabled fill ordered by `order` then by add-on key, so
+ * the order is stable and does not depend on install sequence. `single` takes
+ * the lowest `order` and records a SLOT_CONFLICT warning naming the add-on that
+ * lost — never a silent override.
+ */
+export const SLOT_FILLS = ['multi', 'single', 'per-add-on'];
+export const SLOT_REGISTRY = [
+    {
+        id: 'artwork.sources',
+        surface: 'customer',
+        fill: 'multi',
+        payload: 'the configured job: product, trim size mm, bleed mm, sides, quantity',
+        renders: 'an action tile, and a flow resolving to an ArtworkRef',
+    },
+    {
+        id: 'checkout.delivery.methods',
+        surface: 'customer',
+        fill: 'multi',
+        payload: 'parcel estimate + destination',
+        renders: 'selectable rate rows',
+    },
+    {
+        id: 'order.dispatch.panel',
+        surface: 'customer',
+        fill: 'single',
+        payload: 'the dispatch record',
+        renders: 'a read-only tracking view',
+    },
+    {
+        // Renamed from `job.dispatch.actions` on 2026-08-05 (D21): the id names a
+        // surface, not the print shop's domain, so a second host can fill it.
+        id: 'order.dispatch.actions',
+        surface: 'staff',
+        fill: 'multi',
+        payload: 'the order + its parcel estimate',
+        renders: 'an action and its result panel',
+    },
+    {
+        id: 'settings.add-on.panel',
+        surface: 'admin',
+        fill: 'per-add-on',
+        // The values, a way to save a change to them, and the host's own catalogue
+        // as representative records. The last of those is what lets an add-on say
+        // something about the host's data — default parcel weights, say — without
+        // the host computing it, which is a thing only the add-on knows how to do.
+        payload: "the add-on's settings values, a patch handle, and sample records",
+        renders: 'a settings form, its controls and the sentence under each',
+    },
+    {
+        id: 'nav.add-on.routes',
+        surface: 'both',
+        fill: 'multi',
+        payload: '—',
+        renders: 'full-screen routes under /add-ons/<key>/*',
+    },
+    {
+        id: 'product.options.personalize',
+        surface: 'customer',
+        fill: 'single',
+        payload: 'the product + its variant and quantity',
+        renders: 'a personalization surface resolving to a Personalization',
+    },
+    {
+        id: 'cart.line.preview',
+        surface: 'customer',
+        fill: 'multi',
+        payload: 'one basket / order line',
+        renders: 'a thumbnail and the values in words',
+    },
+    {
+        id: 'product.admin.panel',
+        surface: 'staff',
+        fill: 'multi',
+        payload: 'the product record',
+        renders: 'a setup panel (zones, constraints, sample)',
+    },
+    {
+        id: 'order.line.actions',
+        surface: 'staff',
+        fill: 'multi',
+        payload: 'one order line',
+        renders: 'per-line actions and their output',
+    },
+    {
+        // The only slot whose host is Adminium itself rather than an example app,
+        // which is why its payload carries a table name.
+        id: 'record.editor.panel',
+        surface: 'admin',
+        fill: 'multi',
+        payload: 'the table name, the record, and write handles',
+        renders: "a panel inside the generated dashboard's record editor",
+    },
+];
+export const SLOT_IDS = SLOT_REGISTRY.map((s) => s.id);
+export const slotIdSchema = z.enum(SLOT_IDS);
+const BY_ID = new Map(SLOT_REGISTRY.map((s) => [s.id, s]));
+export function isSlotId(v) {
+    return typeof v === 'string' && BY_ID.has(v);
+}
+export function slotDefinition(id) {
+    const found = BY_ID.get(id);
+    /* c8 ignore next */
+    if (found === undefined)
+        throw new Error(`unknown slot id: ${id}`);
+    return found;
+}
+//# sourceMappingURL=slots.js.map

package/dist/slots.js.map

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

package/dist/testing/index.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Conformance suites — part of the contract, not a courtesy (24 §5.5, D9).
+ *
+ * Every provider implementation runs the suite for the contract it claims, in
+ * its own repo, against its own transport. The claim "the next carrier is a
+ * copy of this one" rests entirely on `describeShippingCarrier` existing and
+ * passing against both the demo and the real transport; without it the claim is
+ * an assertion in a document.
+ *
+ * This is the ONLY entry point in the package that may import vitest — the
+ * types-and-validators half stays free of test and `node:` imports so the
+ * storefront, the SPAs and Electron can all use it (01 §3).
+ */
+import { type ArtworkSource, type JobSpec } from '../artwork-source.js';
+import { type Personalization, type ProductPersonalizer, type ProductRef, type Template } from '../product-personalizer.js';
+import { type Address, type OrderRef, type Parcel, type ShippingCarrier } from '../shipping-carrier.js';
+export interface ArtworkSourceFixtures {
+    /** A job the source can serve. */
+    job: JobSpec;
+    /** A job it cannot — it must decline WITH A REASON rather than throw. */
+    unavailableJob?: JobSpec;
+    /**
+     * Drives `start()` to its cancel path. Implementations that cannot be
+     * cancelled headlessly may omit it; the cancel assertion is then skipped.
+     */
+    cancel?: () => void;
+}
+export declare function describeArtworkSource(impl: ArtworkSource, fixtures: ArtworkSourceFixtures): void;
+export interface ShippingCarrierFixtures {
+    parcel: Parcel;
+    from: Address;
+    to: Address;
+    /** An address the carrier refuses — the failure path must be demonstrable. */
+    rejectedTo: Address;
+    order: OrderRef;
+}
+export declare function describeShippingCarrier(impl: ShippingCarrier, fixtures: ShippingCarrierFixtures): void;
+export interface ProductPersonalizerFixtures {
+    product: ProductRef;
+    template: Template;
+    /** Values that fit every zone. */
+    valid: Personalization;
+    /** Values that overrun at least one zone — must yield a numbered remedy. */
+    overrun: Personalization;
+    angle: string;
+}
+export declare function describeProductPersonalizer(impl: ProductPersonalizer, fixtures: ProductPersonalizerFixtures): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,EAAoB,KAAK,aAAa,EAAE,KAAK,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC1F,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,UAAU,EACf,KAAK,QAAQ,EACd,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAKL,KAAK,OAAO,EACZ,KAAK,QAAQ,EACb,KAAK,MAAM,EACX,KAAK,eAAe,EACrB,MAAM,wBAAwB,CAAC;AAIhC,MAAM,WAAW,qBAAqB;IACpC,kCAAkC;IAClC,GAAG,EAAE,OAAO,CAAC;IACb,yEAAyE;IACzE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,aAAa,EACnB,QAAQ,EAAE,qBAAqB,GAC9B,IAAI,CA2CN;AAID,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,EAAE,OAAO,CAAC;IACZ,8EAA8E;IAC9E,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,EAAE,QAAQ,CAAC;CACjB;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,eAAe,EACrB,QAAQ,EAAE,uBAAuB,GAChC,IAAI,CAkFN;AAID,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,UAAU,CAAC;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,kCAAkC;IAClC,KAAK,EAAE,eAAe,CAAC;IACvB,4EAA4E;IAC5E,OAAO,EAAE,eAAe,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,mBAAmB,EACzB,QAAQ,EAAE,2BAA2B,GACpC,IAAI,CAqDN"}

package/dist/testing/index.js

@@ -0,0 +1,177 @@
+/**
+ * Conformance suites — part of the contract, not a courtesy (24 §5.5, D9).
+ *
+ * Every provider implementation runs the suite for the contract it claims, in
+ * its own repo, against its own transport. The claim "the next carrier is a
+ * copy of this one" rests entirely on `describeShippingCarrier` existing and
+ * passing against both the demo and the real transport; without it the claim is
+ * an assertion in a document.
+ *
+ * This is the ONLY entry point in the package that may import vitest — the
+ * types-and-validators half stays free of test and `node:` imports so the
+ * storefront, the SPAs and Electron can all use it (01 §3).
+ */
+import { describe, expect, it } from 'vitest';
+import { artworkRefSchema } from '../artwork-source.js';
+import { personalizationSchema, } from '../product-personalizer.js';
+import { CarrierError, rateSchema, shipmentSchema, trackEventSchema, } from '../shipping-carrier.js';
+export function describeArtworkSource(impl, fixtures) {
+    describe(`artwork-source@1 conformance — ${impl.key}`, () => {
+        it('has a non-empty key', () => {
+            expect(impl.key).toMatch(/^[a-z][a-z0-9-]*$/);
+        });
+        it('labels itself for a job without throwing', () => {
+            const label = impl.label(fixtures.job);
+            expect(typeof label).toBe('string');
+            expect(label.length).toBeGreaterThan(0);
+        });
+        it('reports availability as data, never as an exception', () => {
+            const verdict = impl.available(fixtures.job);
+            expect(verdict.ok).toBe(true);
+        });
+        it('declines an unservable job WITH a reason', () => {
+            if (fixtures.unavailableJob === undefined)
+                return;
+            const verdict = impl.available(fixtures.unavailableJob);
+            expect(verdict.ok).toBe(false);
+            if (!verdict.ok)
+                expect(verdict.reason.trim().length).toBeGreaterThan(0);
+        });
+        it('returns an ArtworkRef whose shape the host can check', async () => {
+            const ref = await impl.start(fixtures.job);
+            expect(ref).not.toBeNull();
+            const parsed = artworkRefSchema.safeParse(ref);
+            expect(parsed.success, JSON.stringify(parsed.error?.issues)).toBe(true);
+        });
+        it('stamps the ref with its own key, so the host can trace the source', async () => {
+            const ref = await impl.start(fixtures.job);
+            expect(ref?.source).toBe(impl.key);
+        });
+        it('resolves to null when the customer backs out', async () => {
+            if (fixtures.cancel === undefined)
+                return;
+            const pending = impl.start(fixtures.job);
+            fixtures.cancel();
+            await expect(pending).resolves.toBeNull();
+        });
+    });
+}
+export function describeShippingCarrier(impl, fixtures) {
+    describe(`shipping-carrier@1 conformance — ${impl.key}`, () => {
+        it('has a non-empty key', () => {
+            expect(impl.key).toMatch(/^[a-z][a-z0-9-]*$/);
+        });
+        it('quotes at least one rate, each of the declared shape', async () => {
+            const rates = await impl.quote(fixtures.parcel, fixtures.from, fixtures.to);
+            expect(rates.length).toBeGreaterThan(0);
+            for (const rate of rates) {
+                const parsed = rateSchema.safeParse(rate);
+                expect(parsed.success, JSON.stringify(parsed.error?.issues)).toBe(true);
+            }
+        });
+        it('quote is side-effect free — the same call twice gives the same rates', async () => {
+            const a = await impl.quote(fixtures.parcel, fixtures.from, fixtures.to);
+            const b = await impl.quote(fixtures.parcel, fixtures.from, fixtures.to);
+            expect(b).toEqual(a);
+        });
+        it('surfaces a refusal as a typed CarrierError carrying the carrier’s own message', async () => {
+            await expect(impl.quote(fixtures.parcel, fixtures.from, fixtures.rejectedTo)).rejects.toBeInstanceOf(CarrierError);
+            try {
+                await impl.quote(fixtures.parcel, fixtures.from, fixtures.rejectedTo);
+                expect.unreachable('the rejected address should not have quoted');
+            }
+            catch (err) {
+                expect(err).toBeInstanceOf(CarrierError);
+                const carrier = err;
+                expect(carrier.carrierMessage.trim().length).toBeGreaterThan(0);
+                expect(carrier.code.trim().length).toBeGreaterThan(0);
+            }
+        });
+        it('books a shipment of the declared shape', async () => {
+            const [rate] = await impl.quote(fixtures.parcel, fixtures.from, fixtures.to);
+            expect(rate).toBeDefined();
+            const shipment = await impl.book(rate, fixtures.order);
+            const parsed = shipmentSchema.safeParse(shipment);
+            expect(parsed.success, JSON.stringify(parsed.error?.issues)).toBe(true);
+        });
+        it('book is idempotent for one OrderRef', async () => {
+            const [rate] = await impl.quote(fixtures.parcel, fixtures.from, fixtures.to);
+            const first = await impl.book(rate, fixtures.order);
+            const second = await impl.book(rate, fixtures.order);
+            expect(second.id).toBe(first.id);
+            expect(second.tracking).toBe(first.tracking);
+        });
+        it('tracks a booked shipment with events of the declared shape', async () => {
+            const [rate] = await impl.quote(fixtures.parcel, fixtures.from, fixtures.to);
+            const shipment = await impl.book(rate, fixtures.order);
+            const events = await impl.track(shipment.tracking);
+            expect(events.length).toBeGreaterThan(0);
+            for (const event of events) {
+                const parsed = trackEventSchema.safeParse(event);
+                expect(parsed.success, JSON.stringify(parsed.error?.issues)).toBe(true);
+            }
+        });
+        it('returns empty rather than throwing for an unknown tracking reference', async () => {
+            await expect(impl.track('no-such-reference-0000')).resolves.toEqual([]);
+        });
+        it('produces a label file for a booked shipment', async () => {
+            const [rate] = await impl.quote(fixtures.parcel, fixtures.from, fixtures.to);
+            const shipment = await impl.book(rate, fixtures.order);
+            const file = await impl.label(shipment.id);
+            expect(file.fileId.length).toBeGreaterThan(0);
+            expect(file.bytes).toBeGreaterThan(0);
+        });
+        it('cancels a booked shipment without throwing', async () => {
+            const [rate] = await impl.quote(fixtures.parcel, fixtures.from, fixtures.to);
+            const shipment = await impl.book(rate, fixtures.order);
+            await expect(impl.cancel(shipment.id)).resolves.toBeUndefined();
+        });
+    });
+}
+export function describeProductPersonalizer(impl, fixtures) {
+    describe(`product-personalizer@1 conformance — ${impl.key}`, () => {
+        it('has a non-empty key', () => {
+            expect(impl.key).toMatch(/^[a-z][a-z0-9-]*$/);
+        });
+        it('reports availability as data', () => {
+            expect(impl.available(fixtures.product).ok).toBe(true);
+        });
+        it('accepts a personalization of the declared shape', () => {
+            const parsed = personalizationSchema.safeParse(fixtures.valid);
+            expect(parsed.success, JSON.stringify(parsed.error?.issues)).toBe(true);
+        });
+        it('passes every zone for values that fit', () => {
+            const verdicts = impl.validate(fixtures.valid, fixtures.template);
+            expect(verdicts.every((v) => v.ok)).toBe(true);
+        });
+        it('every failing verdict carries at least one remedy WITH a number', () => {
+            const verdicts = impl.validate(fixtures.overrun, fixtures.template);
+            const failures = verdicts.filter((v) => !v.ok);
+            expect(failures.length).toBeGreaterThan(0);
+            for (const failure of failures) {
+                if (failure.ok)
+                    continue;
+                expect(failure.reason.trim().length).toBeGreaterThan(0);
+                const { setSizeMm, shortenToChars } = failure.remedies;
+                expect(typeof setSizeMm === 'number' || typeof shortenToChars === 'number').toBe(true);
+            }
+        });
+        it('render is deterministic — same values and angle give the same picture', async () => {
+            const a = await impl.render(fixtures.valid, { angle: fixtures.angle, widthPx: 480 });
+            const b = await impl.render(fixtures.valid, { angle: fixtures.angle, widthPx: 480 });
+            expect(b.digest).toBe(a.digest);
+            expect(b.fileId).toBe(a.fileId);
+        });
+        it('render distinguishes different values', async () => {
+            const a = await impl.render(fixtures.valid, { angle: fixtures.angle, widthPx: 480 });
+            const b = await impl.render(fixtures.overrun, { angle: fixtures.angle, widthPx: 480 });
+            expect(b.digest).not.toBe(a.digest);
+        });
+        it('the production file carries outlines, never a font reference', async () => {
+            const file = await impl.productionFile(fixtures.valid);
+            expect(file.bytes).toBeGreaterThan(0);
+            expect(file.filename).not.toMatch(/\.(ttf|otf|woff2?)$/i);
+        });
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

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

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@adminiumjs/add-on-contracts",
+  "version": "0.2.1",
+  "license": "AGPL-3.0-only",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MoSofi/Adminium.git",
+    "directory": "packages/add-on-contracts"
+  },
+  "homepage": "https://adminium.dev",
+  "bugs": "https://github.com/MoSofi/Adminium/issues",
+  "type": "module",
+  "description": "Add-on slot + provider-contract registries, types and conformance suites",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing/index.d.ts",
+      "default": "./dist/testing/index.js"
+    }
+  },
+  "dependencies": {
+    "zod": "^4.4.3"
+  },
+  "peerDependencies": {
+    "vitest": "^3.2.4"
+  },
+  "peerDependenciesMeta": {
+    "vitest": {
+      "optional": true
+    }
+  },
+  "files": [
+    "dist"
+  ]
+}