@tessellatepos/plugin-sdk 0.0.0-stage → 0.0.1-alpha

package/lib/context-D0VJqR7Q.d.ts

@@ -0,0 +1,49 @@
+import { Order, Item } from '@tessellatepos/sdk';
+
+declare enum PluginColumnType {
+    TEXT = "text",
+    VARCHAR = "varchar",
+    INTEGER = "integer",
+    BOOLEAN = "boolean",
+    TIMESTAMP = "timestamp",
+    JSONB = "jsonb"
+}
+interface PluginDatabaseColumn {
+    name: string;
+    type: PluginColumnType;
+    length?: number;
+    nullable?: boolean;
+    unique?: boolean;
+    auto_increment?: boolean;
+    default?: string | number | boolean | null;
+    primaryKey?: boolean;
+}
+interface PluginDatabaseTable {
+    name: string;
+    columns: PluginDatabaseColumn[];
+}
+interface PluginDatabaseMount {
+    tables: PluginDatabaseTable[];
+}
+interface PluginTableClient {
+    find(query?: Record<string, unknown>): Promise<Record<string, unknown>[]>;
+    findOne(id: string | number): Promise<Record<string, unknown> | null>;
+    insert(row: Record<string, unknown>): Promise<Record<string, unknown>>;
+    update(id: string | number, patch: Record<string, unknown>): Promise<Record<string, unknown>>;
+    delete(id: string | number): Promise<void>;
+}
+interface PluginDatabaseRepository {
+    table<Name extends string>(name: Name): PluginTableClient;
+}
+
+interface PluginServerContext {
+    db: PluginDatabaseRepository;
+    session: {
+        deviceId: string;
+        locationId: string;
+    };
+    getOrder(orderId: string): Promise<Order | null>;
+    lookupItem(itemId: string): Promise<Item | null>;
+}
+
+export { type PluginServerContext as P, PluginColumnType as a, type PluginDatabaseColumn as b, type PluginDatabaseMount as c, type PluginDatabaseRepository as d, type PluginDatabaseTable as e, type PluginTableClient as f };

package/lib/src/index.d.ts

@@ -0,0 +1,144 @@
+import { CartItem, Discount, Order } from '@tessellatepos/sdk';
+import { P as PluginServerContext } from '../context-D0VJqR7Q.js';
+export { a as PluginColumnType, b as PluginDatabaseColumn, c as PluginDatabaseMount, d as PluginDatabaseRepository, e as PluginDatabaseTable, f as PluginTableClient } from '../context-D0VJqR7Q.js';
+import React from 'react';
+
+interface PluginApiMountDefinition {
+    route: string;
+    method: PluginApiMethod;
+    handler: (req: PluginApiRequest, ctx: PluginServerContext) => Promise<PluginApiResponse> | PluginApiResponse;
+}
+declare enum PluginApiMethod {
+    GET = "GET",
+    POST = "POST",
+    PUT = "PUT",
+    DELETE = "DELETE"
+}
+interface PluginApiRequest {
+    params: Record<string, string>;
+    query: Record<string, string>;
+    body: unknown;
+}
+interface PluginApiResponse {
+    status?: number;
+    body: unknown;
+}
+
+interface CartApi {
+    getItems(): CartItem[];
+    getTotal(): bigint;
+    addQuantity(item: CartItem): void;
+    removeQuantity(item: CartItem): void;
+    removeItem(item: CartItem): void;
+    clearCart(): void;
+}
+interface OrderApi {
+    readonly discounts: readonly Discount[];
+    completedOrder: Order | null;
+}
+interface SettingsApi {
+    locationId: string;
+    deviceId: string;
+}
+interface PluginApiClient {
+    call<T>(route: string, method: PluginApiMethod, params?: Record<string, string>, body?: unknown): Promise<T>;
+}
+interface PluginContext {
+    cart: CartApi;
+    order: OrderApi;
+    settings: SettingsApi;
+    navigate: (path: string) => void;
+    api: PluginApiClient;
+}
+
+declare enum PluginPermission {
+    CART = "CART",
+    CATALOG = "CATALOG",
+    CHECKOUT = "CHECKOUT",
+    DEVICE = "DEVICE",
+    ORDER = "ORDER"
+}
+interface PluginPermissionProvider {
+    cart: boolean;
+    catalog: boolean;
+    checkout: boolean;
+    device: boolean;
+    order: boolean;
+}
+
+interface PluginManifestAuthor {
+    name: string;
+    email?: string;
+    url?: string;
+}
+interface PluginManifestBugs {
+    url?: string;
+    email?: string;
+}
+interface PluginManifestFunding {
+    type?: string;
+    url: string;
+}
+interface PluginManifest {
+    name: string;
+    version: string;
+    description?: string;
+    keywords?: string[];
+    homepage?: string;
+    bugs?: string | PluginManifestBugs;
+    license?: string;
+    author?: string | PluginManifestAuthor;
+    contributors?: (string | PluginManifestAuthor)[];
+    maintainers?: (string | PluginManifestAuthor)[];
+    funding?: string | PluginManifestFunding | (string | PluginManifestFunding)[];
+    main: string;
+    engines?: {
+        tessellate?: string;
+        [engine: string]: string | undefined;
+    };
+    tessellate: {
+        permissions: PluginPermission[];
+    };
+}
+
+interface PluginUIMountDefinition {
+    mount: PluginUIMountPoint;
+    component: React.ComponentType<{
+        context: PluginContext;
+    }>;
+}
+declare enum PluginUIMountPoint {
+    PAGE = "page",
+    CART_SIDEBAR = "cart-sidebar",
+    CHECKOUT_FOOTER = "checkout-footer",
+    SETTINGS_TAB = "settings-tab",
+    RECEIPT_EXTRA = "receipt-extra"
+}
+
+/**
+ * Client-side plugin instance, mirroring the server-side Plugin class but
+ * scoped to UI mount registration only. The plugin's client entry's default
+ * export receives one of these and calls `register("ui", ...)` to declare
+ * which mount points its React components should render at.
+ */
+declare class FrontendPlugin {
+    private manifest;
+    private uiMounts;
+    constructor(manifest: PluginManifest);
+    register(kind: "ui", mount: PluginUIMountDefinition): void;
+    get(kind: "ui"): PluginUIMountDefinition[];
+    getManifest(): PluginManifest;
+}
+
+/**
+ * Creates a PluginApiClient scoped to a single plugin. All calls are
+ * routed to `/plugins/:pluginName/:route` on the backend, where the
+ * dispatcher only matches that plugin's own API mounts — a plugin
+ * cannot reach another plugin's routes.
+ *
+ * The route is sanitized to prevent path traversal (`..`) from escaping
+ * the plugin's namespace.
+ */
+declare function createPluginApiClient(backendUrl: string, pluginName: string): PluginApiClient;
+
+export { type CartApi, FrontendPlugin, type OrderApi, type PluginApiClient, PluginApiMethod, type PluginApiMountDefinition, type PluginApiRequest, type PluginApiResponse, type PluginContext, type PluginManifest, type PluginManifestAuthor, type PluginManifestBugs, type PluginManifestFunding, PluginPermission, type PluginPermissionProvider, type PluginUIMountDefinition, PluginUIMountPoint, type SettingsApi, createPluginApiClient };

package/lib/src/index.js

@@ -0,0 +1,108 @@
+// src/client/frontendPlugin.ts
+var FrontendPlugin = class {
+  constructor(manifest) {
+    this.uiMounts = [];
+    this.manifest = manifest;
+  }
+  register(kind, mount) {
+    if (kind !== "ui") return;
+    this.uiMounts.push(mount);
+  }
+  get(kind) {
+    if (kind !== "ui") return [];
+    return this.uiMounts;
+  }
+  getManifest() {
+    return this.manifest;
+  }
+};
+
+// src/client/pluginApiClient.ts
+import { bigintReplacer } from "@tessellatepos/sdk";
+function createPluginApiClient(backendUrl, pluginName) {
+  return {
+    async call(route, method, params, body) {
+      const normalizedRoute = route.startsWith("/") ? route : `/${route}`;
+      if (normalizedRoute.includes("..")) {
+        throw new Error(
+          `Plugin API route contains illegal path segment: ${route}`
+        );
+      }
+      const url = new URL(
+        `/plugins/${pluginName}${normalizedRoute}`,
+        backendUrl
+      );
+      const expectedPrefix = `/plugins/${pluginName}/`;
+      if (!url.pathname.startsWith(expectedPrefix)) {
+        throw new Error(
+          `Plugin API route escaped plugin namespace: ${route}`
+        );
+      }
+      if (params) {
+        for (const [key, value] of Object.entries(params)) {
+          url.searchParams.set(key, value);
+        }
+      }
+      const res = await fetch(url, {
+        method,
+        headers: body !== void 0 ? { "Content-Type": "application/json" } : {},
+        body: body !== void 0 ? JSON.stringify(body, bigintReplacer) : void 0
+      });
+      if (!res.ok) {
+        throw new Error(
+          `Plugin API call failed: ${method} ${route} \u2192 ${res.status}`
+        );
+      }
+      return res.json();
+    }
+  };
+}
+
+// src/types/pluginApiMounts.ts
+var PluginApiMethod = /* @__PURE__ */ ((PluginApiMethod2) => {
+  PluginApiMethod2["GET"] = "GET";
+  PluginApiMethod2["POST"] = "POST";
+  PluginApiMethod2["PUT"] = "PUT";
+  PluginApiMethod2["DELETE"] = "DELETE";
+  return PluginApiMethod2;
+})(PluginApiMethod || {});
+
+// src/types/pluginDatabaseMounts.ts
+var PluginColumnType = /* @__PURE__ */ ((PluginColumnType2) => {
+  PluginColumnType2["TEXT"] = "text";
+  PluginColumnType2["VARCHAR"] = "varchar";
+  PluginColumnType2["INTEGER"] = "integer";
+  PluginColumnType2["BOOLEAN"] = "boolean";
+  PluginColumnType2["TIMESTAMP"] = "timestamp";
+  PluginColumnType2["JSONB"] = "jsonb";
+  return PluginColumnType2;
+})(PluginColumnType || {});
+
+// src/types/pluginPermissions.ts
+var PluginPermission = /* @__PURE__ */ ((PluginPermission2) => {
+  PluginPermission2["CART"] = "CART";
+  PluginPermission2["CATALOG"] = "CATALOG";
+  PluginPermission2["CHECKOUT"] = "CHECKOUT";
+  PluginPermission2["DEVICE"] = "DEVICE";
+  PluginPermission2["ORDER"] = "ORDER";
+  return PluginPermission2;
+})(PluginPermission || {});
+
+// src/types/pluginUIMounts.ts
+var PluginUIMountPoint = /* @__PURE__ */ ((PluginUIMountPoint2) => {
+  PluginUIMountPoint2["PAGE"] = "page";
+  PluginUIMountPoint2["CART_SIDEBAR"] = "cart-sidebar";
+  PluginUIMountPoint2["CHECKOUT_FOOTER"] = "checkout-footer";
+  PluginUIMountPoint2["SETTINGS_TAB"] = "settings-tab";
+  PluginUIMountPoint2["RECEIPT_EXTRA"] = "receipt-extra";
+  return PluginUIMountPoint2;
+})(PluginUIMountPoint || {});
+export {
+  FrontendPlugin,
+  PluginApiMethod,
+  PluginColumnType,
+  PluginPermission,
+  PluginUIMountPoint,
+  createPluginApiClient
+};
+//# sourceMappingURL=index.js.map

package/lib/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/client/frontendPlugin.ts","../../src/client/pluginApiClient.ts","../../src/types/pluginApiMounts.ts","../../src/types/pluginDatabaseMounts.ts","../../src/types/pluginPermissions.ts","../../src/types/pluginUIMounts.ts"],"sourcesContent":["import type { PluginManifest } from \"@/types/pluginManifest.ts\";\nimport type { PluginUIMountDefinition } from \"@/types/pluginUIMounts.ts\";\n\n/**\n * Client-side plugin instance, mirroring the server-side Plugin class but\n * scoped to UI mount registration only. The plugin's client entry's default\n * export receives one of these and calls `register(\"ui\", ...)` to declare\n * which mount points its React components should render at.\n */\nexport class FrontendPlugin {\n    private manifest: PluginManifest;\n    private uiMounts: PluginUIMountDefinition[] = [];\n\n    constructor(manifest: PluginManifest) {\n        this.manifest = manifest;\n    }\n\n    public register(kind: \"ui\", mount: PluginUIMountDefinition): void {\n        if (kind !== \"ui\") return;\n        this.uiMounts.push(mount);\n    }\n\n    public get(kind: \"ui\"): PluginUIMountDefinition[] {\n        if (kind !== \"ui\") return [];\n        return this.uiMounts;\n    }\n\n    public getManifest(): PluginManifest {\n        return this.manifest;\n    }\n}\n","import { bigintReplacer } from \"@tessellatepos/sdk\";\nimport type { PluginApiMethod } from \"@/types/pluginApiMounts.ts\";\nimport type { PluginApiClient } from \"@/client/context.ts\";\n\n/**\n * Creates a PluginApiClient scoped to a single plugin. All calls are\n * routed to `/plugins/:pluginName/:route` on the backend, where the\n * dispatcher only matches that plugin's own API mounts — a plugin\n * cannot reach another plugin's routes.\n *\n * The route is sanitized to prevent path traversal (`..`) from escaping\n * the plugin's namespace.\n */\nexport function createPluginApiClient(\n    backendUrl: string,\n    pluginName: string,\n): PluginApiClient {\n    return {\n        async call<T>(\n            route: string,\n            method: PluginApiMethod,\n            params?: Record<string, string>,\n            body?: unknown,\n        ): Promise<T> {\n            // Normalize route: ensure leading slash, reject path traversal\n            const normalizedRoute = route.startsWith(\"/\") ? route : `/${route}`;\n            if (normalizedRoute.includes(\"..\")) {\n                throw new Error(\n                    `Plugin API route contains illegal path segment: ${route}`,\n                );\n            }\n\n            const url = new URL(\n                `/plugins/${pluginName}${normalizedRoute}`,\n                backendUrl,\n            );\n\n            // Verify the resolved pathname is still within the plugin namespace\n            const expectedPrefix = `/plugins/${pluginName}/`;\n            if (!url.pathname.startsWith(expectedPrefix)) {\n                throw new Error(\n                    `Plugin API route escaped plugin namespace: ${route}`,\n                );\n            }\n            if (params) {\n                for (const [key, value] of Object.entries(params)) {\n                    url.searchParams.set(key, value);\n                }\n            }\n\n            const res = await fetch(url, {\n                method,\n                headers:\n                    body !== undefined\n                        ? { \"Content-Type\": \"application/json\" }\n                        : {},\n                body:\n                    body !== undefined\n                        ? JSON.stringify(body, bigintReplacer)\n                        : undefined,\n            });\n\n            if (!res.ok) {\n                throw new Error(\n                    `Plugin API call failed: ${method} ${route} → ${res.status}`,\n                );\n            }\n\n            // TODO: bigint fields in the response arrive as strings because\n            // the backend serializes with bigintReplacer. Auto-revival without\n            // type markers is unreliable, so callers must use parseMoney() or\n            // BigInt() on amount fields as needed.\n            return res.json() as Promise<T>;\n        },\n    };\n}\n","import type { PluginServerContext } from \"@/server/host/context.ts\";\n\nexport interface PluginApiMountDefinition {\n    route: string;\n    method: PluginApiMethod;\n    handler: (\n        req: PluginApiRequest,\n        ctx: PluginServerContext,\n    ) => Promise<PluginApiResponse> | PluginApiResponse;\n}\n\nexport enum PluginApiMethod {\n    GET = \"GET\",\n    POST = \"POST\",\n    PUT = \"PUT\",\n    DELETE = \"DELETE\",\n}\n\nexport interface PluginApiRequest {\n    params: Record<string, string>;\n    query: Record<string, string>;\n    body: unknown;\n}\n\nexport interface PluginApiResponse {\n    status?: number;\n    body: unknown;\n}\n","export enum PluginColumnType {\n    TEXT = \"text\",\n    VARCHAR = \"varchar\",\n    INTEGER = \"integer\",\n    BOOLEAN = \"boolean\",\n    TIMESTAMP = \"timestamp\",\n    JSONB = \"jsonb\",\n}\n\nexport interface PluginDatabaseColumn {\n    name: string;\n    type: PluginColumnType;\n    length?: number;\n    nullable?: boolean;\n    unique?: boolean;\n    auto_increment?: boolean;\n    default?: string | number | boolean | null;\n    primaryKey?: boolean;\n}\n\nexport interface PluginDatabaseTable {\n    name: string;\n    columns: PluginDatabaseColumn[];\n}\n\nexport interface PluginDatabaseMount {\n    tables: PluginDatabaseTable[];\n}\n\nexport interface PluginTableClient {\n    find(query?: Record<string, unknown>): Promise<Record<string, unknown>[]>;\n    findOne(id: string | number): Promise<Record<string, unknown> | null>;\n    insert(row: Record<string, unknown>): Promise<Record<string, unknown>>;\n    update(\n        id: string | number,\n        patch: Record<string, unknown>,\n    ): Promise<Record<string, unknown>>;\n    delete(id: string | number): Promise<void>;\n}\n\nexport interface PluginDatabaseRepository {\n    table<Name extends string>(name: Name): PluginTableClient;\n}\n","export enum PluginPermission {\n    CART = \"CART\",\n    CATALOG = \"CATALOG\",\n    CHECKOUT = \"CHECKOUT\",\n    DEVICE = \"DEVICE\",\n    ORDER = \"ORDER\",\n}\n\nexport interface PluginPermissionProvider {\n    cart: boolean;\n    catalog: boolean;\n    checkout: boolean;\n    device: boolean;\n    order: boolean;\n}\n","import type React from \"react\";\nimport type { PluginContext } from \"@/client/context.ts\";\n\nexport interface PluginUIMountDefinition {\n    mount: PluginUIMountPoint;\n    component: React.ComponentType<{ context: PluginContext }>;\n}\n\nexport enum PluginUIMountPoint {\n    PAGE = \"page\",\n    CART_SIDEBAR = \"cart-sidebar\",\n    CHECKOUT_FOOTER = \"checkout-footer\",\n    SETTINGS_TAB = \"settings-tab\",\n    RECEIPT_EXTRA = \"receipt-extra\",\n}\n"],"mappings":";AASO,IAAM,iBAAN,MAAqB;AAAA,EAIxB,YAAY,UAA0B;AAFtC,SAAQ,WAAsC,CAAC;AAG3C,SAAK,WAAW;AAAA,EACpB;AAAA,EAEO,SAAS,MAAY,OAAsC;AAC9D,QAAI,SAAS,KAAM;AACnB,SAAK,SAAS,KAAK,KAAK;AAAA,EAC5B;AAAA,EAEO,IAAI,MAAuC;AAC9C,QAAI,SAAS,KAAM,QAAO,CAAC;AAC3B,WAAO,KAAK;AAAA,EAChB;AAAA,EAEO,cAA8B;AACjC,WAAO,KAAK;AAAA,EAChB;AACJ;;;AC9BA,SAAS,sBAAsB;AAaxB,SAAS,sBACZ,YACA,YACe;AACf,SAAO;AAAA,IACH,MAAM,KACF,OACA,QACA,QACA,MACU;AAEV,YAAM,kBAAkB,MAAM,WAAW,GAAG,IAAI,QAAQ,IAAI,KAAK;AACjE,UAAI,gBAAgB,SAAS,IAAI,GAAG;AAChC,cAAM,IAAI;AAAA,UACN,mDAAmD,KAAK;AAAA,QAC5D;AAAA,MACJ;AAEA,YAAM,MAAM,IAAI;AAAA,QACZ,YAAY,UAAU,GAAG,eAAe;AAAA,QACxC;AAAA,MACJ;AAGA,YAAM,iBAAiB,YAAY,UAAU;AAC7C,UAAI,CAAC,IAAI,SAAS,WAAW,cAAc,GAAG;AAC1C,cAAM,IAAI;AAAA,UACN,8CAA8C,KAAK;AAAA,QACvD;AAAA,MACJ;AACA,UAAI,QAAQ;AACR,mBAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,MAAM,GAAG;AAC/C,cAAI,aAAa,IAAI,KAAK,KAAK;AAAA,QACnC;AAAA,MACJ;AAEA,YAAM,MAAM,MAAM,MAAM,KAAK;AAAA,QACzB;AAAA,QACA,SACI,SAAS,SACH,EAAE,gBAAgB,mBAAmB,IACrC,CAAC;AAAA,QACX,MACI,SAAS,SACH,KAAK,UAAU,MAAM,cAAc,IACnC;AAAA,MACd,CAAC;AAED,UAAI,CAAC,IAAI,IAAI;AACT,cAAM,IAAI;AAAA,UACN,2BAA2B,MAAM,IAAI,KAAK,WAAM,IAAI,MAAM;AAAA,QAC9D;AAAA,MACJ;AAMA,aAAO,IAAI,KAAK;AAAA,IACpB;AAAA,EACJ;AACJ;;;AChEO,IAAK,kBAAL,kBAAKA,qBAAL;AACH,EAAAA,iBAAA,SAAM;AACN,EAAAA,iBAAA,UAAO;AACP,EAAAA,iBAAA,SAAM;AACN,EAAAA,iBAAA,YAAS;AAJD,SAAAA;AAAA,GAAA;;;ACXL,IAAK,mBAAL,kBAAKC,sBAAL;AACH,EAAAA,kBAAA,UAAO;AACP,EAAAA,kBAAA,aAAU;AACV,EAAAA,kBAAA,aAAU;AACV,EAAAA,kBAAA,aAAU;AACV,EAAAA,kBAAA,eAAY;AACZ,EAAAA,kBAAA,WAAQ;AANA,SAAAA;AAAA,GAAA;;;ACAL,IAAK,mBAAL,kBAAKC,sBAAL;AACH,EAAAA,kBAAA,UAAO;AACP,EAAAA,kBAAA,aAAU;AACV,EAAAA,kBAAA,cAAW;AACX,EAAAA,kBAAA,YAAS;AACT,EAAAA,kBAAA,WAAQ;AALA,SAAAA;AAAA,GAAA;;;ACQL,IAAK,qBAAL,kBAAKC,wBAAL;AACH,EAAAA,oBAAA,UAAO;AACP,EAAAA,oBAAA,kBAAe;AACf,EAAAA,oBAAA,qBAAkB;AAClB,EAAAA,oBAAA,kBAAe;AACf,EAAAA,oBAAA,mBAAgB;AALR,SAAAA;AAAA,GAAA;","names":["PluginApiMethod","PluginColumnType","PluginPermission","PluginUIMountPoint"]}

package/lib/src/server/index.d.ts

@@ -0,0 +1,42 @@
+export { P as PluginServerContext } from '../../context-D0VJqR7Q.js';
+import { Order, TenderType, Money } from '@tessellatepos/sdk';
+
+declare const hooks: {
+    beforeOrderCreate: HookDefinition<Order, Order>;
+    beforeCheckout: HookDefinition<{
+        orderId: string;
+        amount: Money;
+    }, void>;
+    beforePayment: HookDefinition<{
+        orderId: string;
+        method: TenderType;
+    }, void>;
+};
+declare const events: {
+    orderCreated: EventDefinition<(order: Order) => void>;
+    paymentCompleted: EventDefinition<(order: Order, method: TenderType) => void>;
+    orderCancelled: EventDefinition<(order: Order) => void>;
+};
+type HookResult<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    reason: string;
+    code?: string;
+};
+interface HookDefinition<TInput, TOutput = TInput> {
+    readonly name: string;
+    readonly kind: "hook";
+    readonly _input: TInput;
+    readonly _output: TOutput;
+}
+interface EventDefinition<THandler extends (...args: never[]) => void> {
+    readonly name: string;
+    readonly kind: "event";
+    readonly _handler: THandler;
+}
+declare function defineHook<TInput, TOutput = TInput>(name: string): HookDefinition<TInput, TOutput>;
+declare function defineEvent<THandler extends (...args: never[]) => void>(name: string): EventDefinition<THandler>;
+
+export { type EventDefinition, type HookDefinition, type HookResult, defineEvent, defineHook, events, hooks };

package/lib/src/server/index.js

@@ -0,0 +1,30 @@
+// src/server/host/hooks.ts
+var hooks = {
+  beforeOrderCreate: defineHook("beforeOrderCreate"),
+  beforeCheckout: defineHook(
+    "beforeCheckout"
+  ),
+  beforePayment: defineHook(
+    "beforePayment"
+  )
+};
+var events = {
+  orderCreated: defineEvent("orderCreated"),
+  paymentCompleted: defineEvent(
+    "paymentCompleted"
+  ),
+  orderCancelled: defineEvent("orderCancelled")
+};
+function defineHook(name) {
+  return { name, kind: "hook" };
+}
+function defineEvent(name) {
+  return { name, kind: "event" };
+}
+export {
+  defineEvent,
+  defineHook,
+  events,
+  hooks
+};
+//# sourceMappingURL=index.js.map

package/lib/src/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/server/host/hooks.ts"],"sourcesContent":["import type { Order, Money, TenderType } from \"@tessellatepos/sdk\";\n\nexport const hooks = {\n    beforeOrderCreate: defineHook<Order>(\"beforeOrderCreate\"),\n    beforeCheckout: defineHook<{ orderId: string; amount: Money }, void>(\n        \"beforeCheckout\",\n    ),\n    beforePayment: defineHook<{ orderId: string; method: TenderType }, void>(\n        \"beforePayment\",\n    ),\n};\n\nexport const events = {\n    orderCreated: defineEvent<(order: Order) => void>(\"orderCreated\"),\n    paymentCompleted:\n        defineEvent<(order: Order, method: TenderType) => void>(\n            \"paymentCompleted\",\n        ),\n    orderCancelled: defineEvent<(order: Order) => void>(\"orderCancelled\"),\n};\n\nexport type HookResult<T> =\n    { ok: true; value: T } | { ok: false; reason: string; code?: string };\n\nexport interface HookDefinition<TInput, TOutput = TInput> {\n    readonly name: string;\n    readonly kind: \"hook\";\n    readonly _input: TInput;\n    readonly _output: TOutput;\n}\n\nexport interface EventDefinition<THandler extends (...args: never[]) => void> {\n    readonly name: string;\n    readonly kind: \"event\";\n    readonly _handler: THandler;\n}\n\nexport function defineHook<TInput, TOutput = TInput>(\n    name: string,\n): HookDefinition<TInput, TOutput> {\n    return { name, kind: \"hook\" } as HookDefinition<TInput, TOutput>;\n}\n\nexport function defineEvent<THandler extends (...args: never[]) => void>(\n    name: string,\n): EventDefinition<THandler> {\n    return { name, kind: \"event\" } as EventDefinition<THandler>;\n}\n"],"mappings":";AAEO,IAAM,QAAQ;AAAA,EACjB,mBAAmB,WAAkB,mBAAmB;AAAA,EACxD,gBAAgB;AAAA,IACZ;AAAA,EACJ;AAAA,EACA,eAAe;AAAA,IACX;AAAA,EACJ;AACJ;AAEO,IAAM,SAAS;AAAA,EAClB,cAAc,YAAoC,cAAc;AAAA,EAChE,kBACI;AAAA,IACI;AAAA,EACJ;AAAA,EACJ,gBAAgB,YAAoC,gBAAgB;AACxE;AAkBO,SAAS,WACZ,MAC+B;AAC/B,SAAO,EAAE,MAAM,MAAM,OAAO;AAChC;AAEO,SAAS,YACZ,MACyB;AACzB,SAAO,EAAE,MAAM,MAAM,QAAQ;AACjC;","names":[]}

package/package.json

@@ -1,6 +1,47 @@
 {
   "name": "@tessellatepos/plugin-sdk",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.0.1-alpha",
+  "description": "Curated contract surface for Tessellate POS plugins (client + server).",
+  "author": "Tessellate POS <tessellate@travisfriesen.ca>",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "lib/src/index.js",
+  "types": "lib/src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/src/index.d.ts",
+      "default": "./lib/src/index.js"
+    },
+    "./server": {
+      "types": "./lib/src/server/index.d.ts",
+      "default": "./lib/src/server/index.js"
+    }
+  },
+  "files": [
+    "lib"
+  ],
+  "dependencies": {
+    "@tessellatepos/sdk": "0.0.1-alpha",
+    "react": "^19.2.3"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.5",
+    "@types/node": "^24.10.9",
+    "@types/react": "^19.2.5",
+    "eslint": "^9.39.5",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.6",
+    "globals": "^17.11.0",
+    "jiti": "^2.6.1",
+    "prettier": "^3.9.6",
+    "tsup": "^8.5.1",
+    "typescript": "~5.9.3",
+    "typescript-eslint": "^8.68.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "lint": "prettier . && eslint .",
+    "lint:fix": "prettier . --write && eslint . --fix"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.