@adminiumjs/add-on-contracts 0.2.1

package/dist/add-on-block.d.ts

@@ -0,0 +1,155 @@
+/**
+ * The `addOn` manifest block (24-marketplace-wave-4.md §5.3) and its validation
+ * rules. Lives here rather than in `@adminium/manifest` because the rules are
+ * assertions ABOUT the registries in this package — a slot id or a contract id
+ * is only meaningful against the closed lists in `slots.ts` / `contracts.ts`.
+ *
+ * `@adminium/manifest` imports this to build the `kind: "add-on"` branch of its
+ * discriminated union.
+ */
+import { z } from 'zod';
+/**
+ * Add-ons get their OWN closed category vocabulary (D2), because an add-on is
+ * not a vertical and forcing it into the app facet set would make a carrier a
+ * "commerce" product. Wave 4 uses two of the five; the other three exist so a
+ * second add-on wave does not have to reopen the vocabulary.
+ */
+export declare const ADD_ON_CATEGORIES: readonly ["artwork", "delivery", "payments", "email", "data"];
+export declare const addOnCategorySchema: z.ZodEnum<{
+    artwork: "artwork";
+    delivery: "delivery";
+    payments: "payments";
+    email: "email";
+    data: "data";
+}>;
+export type AddOnCategory = (typeof ADD_ON_CATEGORIES)[number];
+/** How the shop supplies credentials, if at all (§5.6). */
+export declare const CONNECT_KINDS: readonly ["none", "api-key", "oauth2"];
+export declare const connectKindSchema: z.ZodEnum<{
+    none: "none";
+    "api-key": "api-key";
+    oauth2: "oauth2";
+}>;
+export type ConnectKind = (typeof CONNECT_KINDS)[number];
+export declare const attachTargetSchema: z.ZodObject<{
+    app: z.ZodUnion<readonly [z.ZodLiteral<"*">, z.ZodString]>;
+    range: z.ZodOptional<z.ZodString>;
+    table: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const providesSchema: z.ZodObject<{
+    contract: z.ZodEnum<{
+        "artwork-source": "artwork-source";
+        "shipping-carrier": "shipping-carrier";
+        "product-personalizer": "product-personalizer";
+    }>;
+    version: z.ZodNumber;
+    server: z.ZodString;
+}, z.core.$strict>;
+export declare const consumesSchema: z.ZodObject<{
+    contract: z.ZodEnum<{
+        "artwork-source": "artwork-source";
+        "shipping-carrier": "shipping-carrier";
+        "product-personalizer": "product-personalizer";
+    }>;
+    version: z.ZodNumber;
+}, z.core.$strict>;
+export declare const slotFillSchema: z.ZodObject<{
+    slot: z.ZodEnum<{
+        "artwork.sources": "artwork.sources";
+        "checkout.delivery.methods": "checkout.delivery.methods";
+        "order.dispatch.panel": "order.dispatch.panel";
+        "order.dispatch.actions": "order.dispatch.actions";
+        "settings.add-on.panel": "settings.add-on.panel";
+        "nav.add-on.routes": "nav.add-on.routes";
+        "product.options.personalize": "product.options.personalize";
+        "cart.line.preview": "cart.line.preview";
+        "product.admin.panel": "product.admin.panel";
+        "order.line.actions": "order.line.actions";
+        "record.editor.panel": "record.editor.panel";
+    }>;
+    client: z.ZodString;
+    order: z.ZodNumber;
+}, z.core.$strict>;
+export declare const addOnEventSchema: z.ZodObject<{
+    on: z.ZodString;
+    server: z.ZodString;
+}, z.core.$strict>;
+export declare const addOnConnectSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        none: "none";
+        "api-key": "api-key";
+        oauth2: "oauth2";
+    }>;
+    authorizeUrl: z.ZodOptional<z.ZodURL>;
+    tokenUrl: z.ZodOptional<z.ZodURL>;
+    scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+export declare const addOnNetworkSchema: z.ZodObject<{
+    allow: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export declare const addOnBlockSchema: z.ZodObject<{
+    attaches: z.ZodArray<z.ZodObject<{
+        app: z.ZodUnion<readonly [z.ZodLiteral<"*">, z.ZodString]>;
+        range: z.ZodOptional<z.ZodString>;
+        table: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    provides: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        contract: z.ZodEnum<{
+            "artwork-source": "artwork-source";
+            "shipping-carrier": "shipping-carrier";
+            "product-personalizer": "product-personalizer";
+        }>;
+        version: z.ZodNumber;
+        server: z.ZodString;
+    }, z.core.$strict>>>;
+    consumes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        contract: z.ZodEnum<{
+            "artwork-source": "artwork-source";
+            "shipping-carrier": "shipping-carrier";
+            "product-personalizer": "product-personalizer";
+        }>;
+        version: z.ZodNumber;
+    }, z.core.$strict>>>;
+    slots: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        slot: z.ZodEnum<{
+            "artwork.sources": "artwork.sources";
+            "checkout.delivery.methods": "checkout.delivery.methods";
+            "order.dispatch.panel": "order.dispatch.panel";
+            "order.dispatch.actions": "order.dispatch.actions";
+            "settings.add-on.panel": "settings.add-on.panel";
+            "nav.add-on.routes": "nav.add-on.routes";
+            "product.options.personalize": "product.options.personalize";
+            "cart.line.preview": "cart.line.preview";
+            "product.admin.panel": "product.admin.panel";
+            "order.line.actions": "order.line.actions";
+            "record.editor.panel": "record.editor.panel";
+        }>;
+        client: z.ZodString;
+        order: z.ZodNumber;
+    }, z.core.$strict>>>;
+    events: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        on: z.ZodString;
+        server: z.ZodString;
+    }, z.core.$strict>>>;
+    connect: z.ZodObject<{
+        kind: z.ZodEnum<{
+            none: "none";
+            "api-key": "api-key";
+            oauth2: "oauth2";
+        }>;
+        authorizeUrl: z.ZodOptional<z.ZodURL>;
+        tokenUrl: z.ZodOptional<z.ZodURL>;
+        scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>;
+    scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    network: z.ZodOptional<z.ZodObject<{
+        allow: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    publicSettings: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    demoTransport: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type AddOnBlock = z.infer<typeof addOnBlockSchema>;
+/** Issue codes the validators emit (13 §3.2 convention, extended by 24 §5.3). */
+export declare const ADD_ON_ISSUE_CODES: readonly ["ATTACH_TARGET_UNKNOWN", "SLOT_UNKNOWN", "CONTRACT_UNKNOWN", "SCOPE_OUT_OF_RANGE", "NETWORK_ALLOW_REQUIRED", "CAPABILITY_CONFLICT", "FRONTEND_SECRET_LEAK", "SLOT_CONFLICT"];
+export type AddOnIssueCode = (typeof ADD_ON_ISSUE_CODES)[number];
+//# sourceMappingURL=add-on-block.d.ts.map

package/dist/add-on-block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-on-block.d.ts","sourceRoot":"","sources":["../src/add-on-block.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,+DAAgE,CAAC;AAC/F,eAAO,MAAM,mBAAmB;;;;;;EAA4B,CAAC;AAC7D,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,2DAA2D;AAC3D,eAAO,MAAM,aAAa,wCAAyC,CAAC;AACpE,eAAO,MAAM,iBAAiB;;;;EAAwB,CAAC;AACvD,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAazD,eAAO,MAAM,kBAAkB;;;;kBAQpB,CAAC;AAEZ,eAAO,MAAM,cAAc;;;;;;;;kBAMhB,CAAC;AAEZ,eAAO,MAAM,cAAc;;;;;;;kBAKhB,CAAC;AAEZ,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;kBAMhB,CAAC;AAEZ,eAAO,MAAM,gBAAgB;;;kBAKlB,CAAC;AAEZ,eAAO,MAAM,kBAAkB;;;;;;;;;kBAOpB,CAAC;AAEZ,eAAO,MAAM,kBAAkB;;kBAIpB,CAAC;AAEZ,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAmC1B,CAAC;AAEJ,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,wLASrB,CAAC;AACX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/add-on-block.js

@@ -0,0 +1,124 @@
+/**
+ * The `addOn` manifest block (24-marketplace-wave-4.md §5.3) and its validation
+ * rules. Lives here rather than in `@adminium/manifest` because the rules are
+ * assertions ABOUT the registries in this package — a slot id or a contract id
+ * is only meaningful against the closed lists in `slots.ts` / `contracts.ts`.
+ *
+ * `@adminium/manifest` imports this to build the `kind: "add-on"` branch of its
+ * discriminated union.
+ */
+import { z } from 'zod';
+import { contractIdSchema, hasContractVersion } from './contracts.js';
+import { slotIdSchema } from './slots.js';
+/**
+ * Add-ons get their OWN closed category vocabulary (D2), because an add-on is
+ * not a vertical and forcing it into the app facet set would make a carrier a
+ * "commerce" product. Wave 4 uses two of the five; the other three exist so a
+ * second add-on wave does not have to reopen the vocabulary.
+ */
+export const ADD_ON_CATEGORIES = ['artwork', 'delivery', 'payments', 'email', 'data'];
+export const addOnCategorySchema = z.enum(ADD_ON_CATEGORIES);
+/** How the shop supplies credentials, if at all (§5.6). */
+export const CONNECT_KINDS = ['none', 'api-key', 'oauth2'];
+export const connectKindSchema = z.enum(CONNECT_KINDS);
+const SEMVER_RANGE = /^[\^~]?(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$|^\*$/;
+/**
+ * Exact hostname — no wildcards, no bare IPs, no ports, no scheme (D14).
+ *
+ * The final label is alphabetic on purpose: it is what makes `203.0.113.10`
+ * fail. Every real TLD is alphabetic, and an egress allow-list that quietly
+ * accepts a literal IP is an allow-list with a hole in it.
+ */
+const HOSTNAME = /^(?!-)[a-z0-9-]{1,63}(?<!-)(\.(?!-)[a-z0-9-]{1,63}(?<!-))*\.[a-z]{2,63}$/;
+export const attachTargetSchema = z
+    .object({
+    /** A known app key, or `"*"` when the contract is not host-specific. */
+    app: z.union([z.literal('*'), z.string().regex(/^[a-z][a-z0-9-]{1,79}$/)]),
+    range: z.string().regex(SEMVER_RANGE, 'range must be a simple semver range or "*"').optional(),
+    /** Only for `record.editor.panel`: which host tables the panel mounts on. */
+    table: z.string().regex(/^[a-z][a-z0-9_]*$/).optional(),
+})
+    .strict();
+export const providesSchema = z
+    .object({
+    contract: contractIdSchema,
+    version: z.number().int().positive(),
+    server: z.string().min(1),
+})
+    .strict();
+export const consumesSchema = z
+    .object({
+    contract: contractIdSchema,
+    version: z.number().int().positive(),
+})
+    .strict();
+export const slotFillSchema = z
+    .object({
+    slot: slotIdSchema,
+    client: z.string().min(1),
+    order: z.number().int(),
+})
+    .strict();
+export const addOnEventSchema = z
+    .object({
+    on: z.string().min(1).max(80),
+    server: z.string().min(1),
+})
+    .strict();
+export const addOnConnectSchema = z
+    .object({
+    kind: connectKindSchema,
+    authorizeUrl: z.url().optional(),
+    tokenUrl: z.url().optional(),
+    scopes: z.array(z.string().min(1)).optional(),
+})
+    .strict();
+export const addOnNetworkSchema = z
+    .object({
+    allow: z.array(z.string().regex(HOSTNAME, 'must be an exact https hostname')),
+})
+    .strict();
+export const addOnBlockSchema = z
+    .object({
+    attaches: z.array(attachTargetSchema).min(1),
+    provides: z.array(providesSchema).optional(),
+    consumes: z.array(consumesSchema).optional(),
+    slots: z.array(slotFillSchema).optional(),
+    events: z.array(addOnEventSchema).optional(),
+    connect: addOnConnectSchema,
+    /** Grants over host + own tables, checked against SCOPE_OUT_OF_RANGE. */
+    scopes: z.array(z.string().min(1)).optional(),
+    network: addOnNetworkSchema.optional(),
+    /** D15 — the only settings the client bundle may read. */
+    publicSettings: z.array(z.string().min(1)).optional(),
+    /** D11 — required to ship a demo that makes no real third-party call. */
+    demoTransport: z.string().min(1).optional(),
+})
+    .strict()
+    // Every `provides[].contract` must be in the registry AT the declared version.
+    .refine((b) => (b.provides ?? []).every((p) => hasContractVersion(p.contract, p.version)), {
+    message: 'CONTRACT_UNKNOWN: a provided contract is not in the registry at that version',
+    path: ['provides'],
+})
+    .refine((b) => (b.consumes ?? []).every((c) => hasContractVersion(c.contract, c.version)), {
+    message: 'CONTRACT_UNKNOWN: a consumed contract is not in the registry at that version',
+    path: ['consumes'],
+})
+    // §5.6 — an oauth2 connect must name where it authorizes.
+    .refine((b) => b.connect.kind !== 'oauth2' ||
+    (b.connect.authorizeUrl !== undefined && b.connect.tokenUrl !== undefined), {
+    message: 'an oauth2 connect must declare authorizeUrl and tokenUrl',
+    path: ['connect'],
+});
+/** Issue codes the validators emit (13 §3.2 convention, extended by 24 §5.3). */
+export const ADD_ON_ISSUE_CODES = [
+    'ATTACH_TARGET_UNKNOWN',
+    'SLOT_UNKNOWN',
+    'CONTRACT_UNKNOWN',
+    'SCOPE_OUT_OF_RANGE',
+    'NETWORK_ALLOW_REQUIRED',
+    'CAPABILITY_CONFLICT',
+    'FRONTEND_SECRET_LEAK',
+    'SLOT_CONFLICT',
+];
+//# sourceMappingURL=add-on-block.js.map

package/dist/add-on-block.js.map

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

package/dist/artwork-source.d.ts

@@ -0,0 +1,71 @@
+/**
+ * `artwork-source@1` (24 §5.5) — a way for a customer to supply artwork that is
+ * not a plain upload.
+ *
+ * The asymmetry that makes this contract worth having: the HOST, not the
+ * add-on, runs the artwork checks on the returned `ArtworkRef`. Design Studio's
+ * output passes by construction because it was built at the finished size with
+ * the bleed already on it; a design brought in from somewhere else routinely
+ * does not. Neither implementation marks its own homework.
+ */
+import { z } from 'zod';
+/** The job the customer is supplying artwork for. */
+export interface JobSpec {
+    /** Product family key, e.g. `business-cards`. */
+    productKey: string;
+    /** Human label for the product, already localized by the host. */
+    productLabel: string;
+    /** Finished (trim) size in millimetres. */
+    trimWidthMm: number;
+    trimHeightMm: number;
+    /** Bleed the works needs on every edge, in millimetres. */
+    bleedMm: number;
+    sides: 1 | 2;
+    quantity: number;
+}
+/** What an artwork source hands back to the host. */
+export interface ArtworkRef {
+    fileId: string;
+    /** The add-on key that produced it. */
+    source: string;
+    widthMm: number;
+    heightMm: number;
+    bleedMm: number;
+    dpi: number;
+    pages: number;
+    previewFileId?: string;
+}
+export interface ArtworkSource {
+    readonly key: string;
+    /** e.g. "Design it here" / "Bring it from Canva" — the host renders it. */
+    label(job: JobSpec): string;
+    available(job: JobSpec): AvailabilityVerdict;
+    /** Resolves to the artwork, or null when the customer backed out. */
+    start(job: JobSpec): Promise<ArtworkRef | null>;
+}
+export type AvailabilityVerdict = {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};
+export declare const jobSpecSchema: z.ZodObject<{
+    productKey: z.ZodString;
+    productLabel: z.ZodString;
+    trimWidthMm: z.ZodNumber;
+    trimHeightMm: z.ZodNumber;
+    bleedMm: z.ZodNumber;
+    sides: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>]>;
+    quantity: z.ZodNumber;
+}, z.core.$strict>;
+export declare const artworkRefSchema: z.ZodObject<{
+    fileId: z.ZodString;
+    source: z.ZodString;
+    widthMm: z.ZodNumber;
+    heightMm: z.ZodNumber;
+    bleedMm: z.ZodNumber;
+    dpi: z.ZodNumber;
+    pages: z.ZodNumber;
+    previewFileId: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+//# sourceMappingURL=artwork-source.d.ts.map

package/dist/artwork-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artwork-source.d.ts","sourceRoot":"","sources":["../src/artwork-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,qDAAqD;AACrD,MAAM,WAAW,OAAO;IACtB,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,YAAY,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qDAAqD;AACrD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC;IAC5B,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,mBAAmB,CAAC;IAC7C,qEAAqE;IACrE,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;CACjD;AAED,MAAM,MAAM,mBAAmB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/E,eAAO,MAAM,aAAa;;;;;;;;kBAUf,CAAC;AAEZ,eAAO,MAAM,gBAAgB;;;;;;;;;kBAWlB,CAAC"}

package/dist/artwork-source.js

@@ -0,0 +1,35 @@
+/**
+ * `artwork-source@1` (24 §5.5) — a way for a customer to supply artwork that is
+ * not a plain upload.
+ *
+ * The asymmetry that makes this contract worth having: the HOST, not the
+ * add-on, runs the artwork checks on the returned `ArtworkRef`. Design Studio's
+ * output passes by construction because it was built at the finished size with
+ * the bleed already on it; a design brought in from somewhere else routinely
+ * does not. Neither implementation marks its own homework.
+ */
+import { z } from 'zod';
+export const jobSpecSchema = z
+    .object({
+    productKey: z.string().min(1),
+    productLabel: z.string().min(1),
+    trimWidthMm: z.number().positive(),
+    trimHeightMm: z.number().positive(),
+    bleedMm: z.number().min(0),
+    sides: z.union([z.literal(1), z.literal(2)]),
+    quantity: z.number().int().positive(),
+})
+    .strict();
+export const artworkRefSchema = z
+    .object({
+    fileId: z.string().min(1),
+    source: z.string().min(1),
+    widthMm: z.number().positive(),
+    heightMm: z.number().positive(),
+    bleedMm: z.number().min(0),
+    dpi: z.number().positive(),
+    pages: z.number().int().positive(),
+    previewFileId: z.string().min(1).optional(),
+})
+    .strict();
+//# sourceMappingURL=artwork-source.js.map

package/dist/artwork-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artwork-source.js","sourceRoot":"","sources":["../src/artwork-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAyCxB,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC;KAC3B,MAAM,CAAC;IACN,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;CACtC,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC;KAC9B,MAAM,CAAC;IACN,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAClC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC5C,CAAC;KACD,MAAM,EAAE,CAAC"}

package/dist/common.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Shapes shared by more than one contract. Kept in one place so a `FileRef`
+ * from a carrier label and a `FileRef` from a production file are the same
+ * type — the host stores both through one file seam.
+ */
+import { z } from 'zod';
+export interface FileRef {
+    fileId: string;
+    filename: string;
+    mediaType: string;
+    bytes: number;
+}
+export declare const fileRefSchema: z.ZodObject<{
+    fileId: z.ZodString;
+    filename: z.ZodString;
+    mediaType: z.ZodString;
+    bytes: z.ZodNumber;
+}, z.core.$strict>;
+//# sourceMappingURL=common.d.ts.map

package/dist/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../src/common.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,aAAa;;;;;kBAOf,CAAC"}

package/dist/common.js

@@ -0,0 +1,15 @@
+/**
+ * Shapes shared by more than one contract. Kept in one place so a `FileRef`
+ * from a carrier label and a `FileRef` from a production file are the same
+ * type — the host stores both through one file seam.
+ */
+import { z } from 'zod';
+export const fileRefSchema = z
+    .object({
+    fileId: z.string().min(1),
+    filename: z.string().min(1),
+    mediaType: z.string().min(1),
+    bytes: z.number().int().positive(),
+})
+    .strict();
+//# sourceMappingURL=common.js.map

package/dist/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../src/common.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC;KAC3B,MAAM,CAAC;IACN,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC;KACD,MAAM,EAAE,CAAC"}

package/dist/contracts.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Provider contract registry v1 — CLOSED (24-marketplace-wave-4.md §5.5).
+ *
+ * Three, not eight. A contract that has no implementation is a guess about a
+ * future add-on; the only way a contract gets in is alongside the add-on that
+ * implements it.
+ */
+import { z } from 'zod';
+export interface ContractDefinition {
+    readonly id: string;
+    readonly version: 1;
+    readonly summary: string;
+    /** How many add-ons implement it in wave 4 — the evidence the shape is real. */
+    readonly implementations: number;
+}
+export declare const CONTRACT_REGISTRY: readonly [{
+    readonly id: "artwork-source";
+    readonly version: 1;
+    readonly summary: "A way for a customer to supply artwork that is not an upload. The host runs the checks on what comes back, so no implementation marks its own homework.";
+    readonly implementations: 2;
+}, {
+    readonly id: "shipping-carrier";
+    readonly version: 1;
+    readonly summary: "One delivery company: rates, booking, tracking, labels. Implemented so the second one is a copy.";
+    readonly implementations: 1;
+}, {
+    readonly id: "product-personalizer";
+    readonly version: 1;
+    readonly summary: "Personalization spanning three surfaces — shopper, staff, dashboard — which is why it is a contract rather than a screen.";
+    readonly implementations: 1;
+}];
+export type ContractId = (typeof CONTRACT_REGISTRY)[number]['id'];
+export declare const CONTRACT_IDS: readonly ContractId[];
+export declare const contractIdSchema: z.ZodEnum<{
+    "artwork-source": "artwork-source";
+    "shipping-carrier": "shipping-carrier";
+    "product-personalizer": "product-personalizer";
+}>;
+export declare function isContractId(v: unknown): v is ContractId;
+/** True when the registry carries this contract AT the declared version. */
+export declare function hasContractVersion(id: string, version: number): boolean;
+//# sourceMappingURL=contracts.d.ts.map

package/dist/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../src/contracts.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,gFAAgF;IAChF,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;EAsBoB,CAAC;AAEnD,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC;AAElE,eAAO,MAAM,YAAY,EAAyC,SAAS,UAAU,EAAE,CAAC;AAExF,eAAO,MAAM,gBAAgB;;;;EAE5B,CAAC;AAIF,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,UAAU,CAExD;AAED,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAGvE"}

package/dist/contracts.js

@@ -0,0 +1,40 @@
+/**
+ * Provider contract registry v1 — CLOSED (24-marketplace-wave-4.md §5.5).
+ *
+ * Three, not eight. A contract that has no implementation is a guess about a
+ * future add-on; the only way a contract gets in is alongside the add-on that
+ * implements it.
+ */
+import { z } from 'zod';
+export const CONTRACT_REGISTRY = [
+    {
+        id: 'artwork-source',
+        version: 1,
+        summary: 'A way for a customer to supply artwork that is not an upload. The host runs the checks on what comes back, so no implementation marks its own homework.',
+        implementations: 2,
+    },
+    {
+        id: 'shipping-carrier',
+        version: 1,
+        summary: 'One delivery company: rates, booking, tracking, labels. Implemented so the second one is a copy.',
+        implementations: 1,
+    },
+    {
+        id: 'product-personalizer',
+        version: 1,
+        summary: 'Personalization spanning three surfaces — shopper, staff, dashboard — which is why it is a contract rather than a screen.',
+        implementations: 1,
+    },
+];
+export const CONTRACT_IDS = CONTRACT_REGISTRY.map((c) => c.id);
+export const contractIdSchema = z.enum(CONTRACT_IDS);
+const BY_ID = new Map(CONTRACT_REGISTRY.map((c) => [c.id, c]));
+export function isContractId(v) {
+    return typeof v === 'string' && BY_ID.has(v);
+}
+/** True when the registry carries this contract AT the declared version. */
+export function hasContractVersion(id, version) {
+    const found = BY_ID.get(id);
+    return found !== undefined && found.version === version;
+}
+//# sourceMappingURL=contracts.js.map

package/dist/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../src/contracts.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B;QACE,EAAE,EAAE,gBAAgB;QACpB,OAAO,EAAE,CAAC;QACV,OAAO,EACL,yJAAyJ;QAC3J,eAAe,EAAE,CAAC;KACnB;IACD;QACE,EAAE,EAAE,kBAAkB;QACtB,OAAO,EAAE,CAAC;QACV,OAAO,EACL,kGAAkG;QACpG,eAAe,EAAE,CAAC;KACnB;IACD;QACE,EAAE,EAAE,sBAAsB;QAC1B,OAAO,EAAE,CAAC;QACV,OAAO,EACL,2HAA2H;QAC7H,eAAe,EAAE,CAAC;KACnB;CAC+C,CAAC;AAInD,MAAM,CAAC,MAAM,YAAY,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAA0B,CAAC;AAExF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,CACpC,YAAwD,CACzD,CAAC;AAEF,MAAM,KAAK,GAAG,IAAI,GAAG,CAA6B,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAE3F,MAAM,UAAU,YAAY,CAAC,CAAU;IACrC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,kBAAkB,CAAC,EAAU,EAAE,OAAe;IAC5D,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC5B,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,KAAK,OAAO,CAAC;AAC1D,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @adminium/add-on-contracts — the shapes an add-on is written against
+ * (24-marketplace-wave-4.md §5).
+ *
+ * Two halves, kept apart on purpose. THIS half is types, registries and Zod
+ * validators with zero `node:` imports, so the storefront, the example-app SPAs
+ * and Electron can all use it (01 §3). The conformance suites live behind
+ * `@adminium/add-on-contracts/testing`, which may import vitest.
+ */
+export declare const PACKAGE_NAME = "@adminium/add-on-contracts";
+export { fileRefSchema, type FileRef } from './common.js';
+export { SLOT_REGISTRY, SLOT_IDS, SLOT_SURFACES, SLOT_FILLS, slotIdSchema, isSlotId, slotDefinition, type SlotId, type SlotDefinition, type SlotSurface, type SlotFill, } from './slots.js';
+export { CONTRACT_REGISTRY, CONTRACT_IDS, contractIdSchema, isContractId, hasContractVersion, type ContractId, type ContractDefinition, } from './contracts.js';
+export { ADD_ON_CATEGORIES, ADD_ON_ISSUE_CODES, CONNECT_KINDS, addOnBlockSchema, addOnCategorySchema, addOnConnectSchema, addOnEventSchema, addOnNetworkSchema, attachTargetSchema, connectKindSchema, consumesSchema, providesSchema, slotFillSchema, type AddOnBlock, type AddOnCategory, type AddOnIssueCode, type ConnectKind, } from './add-on-block.js';
+export { artworkRefSchema, jobSpecSchema, type ArtworkRef, type ArtworkSource, type AvailabilityVerdict, type JobSpec, } from './artwork-source.js';
+export { CarrierError, addressSchema, parcelSchema, rateSchema, shipmentSchema, trackEventSchema, type Address, type OrderRef, type Parcel, type Rate, type Shipment, type ShippingCarrier, type TrackEvent, } from './shipping-carrier.js';
+export { personalizationSchema, templateSchema, zoneSchema, type Personalization, type PreviewRef, type ProductPersonalizer, type ProductRef, type Template, type Verdict, type Zone, type ZoneFinish, type ZoneKind, } from './product-personalizer.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,+BAA+B,CAAC;AAEzD,OAAO,EAAE,aAAa,EAAE,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAE1D,OAAO,EACL,aAAa,EACb,QAAQ,EACR,aAAa,EACb,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,KAAK,MAAM,EACX,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,QAAQ,GACd,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,EAClB,KAAK,UAAU,EACf,KAAK,kBAAkB,GACxB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,cAAc,EACd,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,WAAW,GACjB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,OAAO,GACb,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,KAAK,OAAO,EACZ,KAAK,QAAQ,EACb,KAAK,MAAM,EACX,KAAK,IAAI,EACT,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,UAAU,GAChB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,UAAU,EACV,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,OAAO,EACZ,KAAK,IAAI,EACT,KAAK,UAAU,EACf,KAAK,QAAQ,GACd,MAAM,2BAA2B,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+/**
+ * @adminium/add-on-contracts — the shapes an add-on is written against
+ * (24-marketplace-wave-4.md §5).
+ *
+ * Two halves, kept apart on purpose. THIS half is types, registries and Zod
+ * validators with zero `node:` imports, so the storefront, the example-app SPAs
+ * and Electron can all use it (01 §3). The conformance suites live behind
+ * `@adminium/add-on-contracts/testing`, which may import vitest.
+ */
+export const PACKAGE_NAME = '@adminium/add-on-contracts';
+export { fileRefSchema } from './common.js';
+export { SLOT_REGISTRY, SLOT_IDS, SLOT_SURFACES, SLOT_FILLS, slotIdSchema, isSlotId, slotDefinition, } from './slots.js';
+export { CONTRACT_REGISTRY, CONTRACT_IDS, contractIdSchema, isContractId, hasContractVersion, } from './contracts.js';
+export { ADD_ON_CATEGORIES, ADD_ON_ISSUE_CODES, CONNECT_KINDS, addOnBlockSchema, addOnCategorySchema, addOnConnectSchema, addOnEventSchema, addOnNetworkSchema, attachTargetSchema, connectKindSchema, consumesSchema, providesSchema, slotFillSchema, } from './add-on-block.js';
+export { artworkRefSchema, jobSpecSchema, } from './artwork-source.js';
+export { CarrierError, addressSchema, parcelSchema, rateSchema, shipmentSchema, trackEventSchema, } from './shipping-carrier.js';
+export { personalizationSchema, templateSchema, zoneSchema, } from './product-personalizer.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,4BAA4B,CAAC;AAEzD,OAAO,EAAE,aAAa,EAAgB,MAAM,aAAa,CAAC;AAE1D,OAAO,EACL,aAAa,EACb,QAAQ,EACR,aAAa,EACb,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,cAAc,GAKf,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,GAGnB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,cAAc,GAKf,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,gBAAgB,EAChB,aAAa,GAKd,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,UAAU,EACV,cAAc,EACd,gBAAgB,GAQjB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,UAAU,GAUX,MAAM,2BAA2B,CAAC"}