@porulle/core 0.1.0

package/dist/runtime/kernel-modules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel-modules.d.ts","sourceRoot":"","sources":["../../src/runtime/kernel-modules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAoB3D,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkBrB,CAAC;AAEX,2FAA2F;AAC3F,wBAAgB,wBAAwB,IAAI,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAoBpE;AAED,wBAAgB,8BAA8B,IAAI,SAAS,MAAM,EAAE,CAElE"}

package/dist/runtime/kernel-modules.js

@@ -0,0 +1,62 @@
+import { topoSortModules } from "../kernel/module/index.js";
+import { auditModule } from "../modules/audit/index.js";
+import { analyticsModule } from "../modules/analytics/module.js";
+import { cartModule } from "../modules/cart/module.js";
+import { catalogModule } from "../modules/catalog/module.js";
+import { customersModule } from "../modules/customers/index.js";
+import { fulfillmentModule } from "../modules/fulfillment/module.js";
+import { inventoryModule } from "../modules/inventory/module.js";
+import { mediaModule } from "../modules/media/index.js";
+import { ordersModule } from "../modules/orders/module.js";
+import { organizationModule } from "../modules/organization/index.js";
+import { paymentsModule } from "../modules/payments/module.js";
+import { pricingModule } from "../modules/pricing/index.js";
+import { promotionsModule } from "../modules/promotions/module.js";
+import { searchModule } from "../modules/search/module.js";
+import { shippingModule } from "../modules/shipping/module.js";
+import { taxModule } from "../modules/tax/module.js";
+import { webhooksModule } from "../modules/webhooks/index.js";
+export const KERNEL_ALL_MODULES = {
+    audit: auditModule,
+    webhooks: webhooksModule,
+    media: mediaModule,
+    organization: organizationModule,
+    customers: customersModule,
+    pricing: pricingModule,
+    catalog: catalogModule,
+    inventory: inventoryModule,
+    cart: cartModule,
+    orders: ordersModule,
+    fulfillment: fulfillmentModule,
+    promotions: promotionsModule,
+    search: searchModule,
+    shipping: shippingModule,
+    tax: taxModule,
+    payments: paymentsModule,
+    analytics: analyticsModule,
+};
+/** Strip symmetric/lazy manifest edges so topo sort reflects constructor-safe ordering. */
+export function kernelModulesForTopoSort() {
+    return {
+        ...KERNEL_ALL_MODULES,
+        catalog: { ...catalogModule, dependencies: [] },
+        promotions: {
+            ...promotionsModule,
+            dependencies: ["catalog"],
+        },
+        orders: {
+            ...ordersModule,
+            dependencies: [
+                "cart",
+                "inventory",
+                "payments",
+                "pricing",
+                "fulfillment",
+                "tax",
+            ],
+        },
+    };
+}
+export function kernelModuleInstantiationOrder() {
+    return topoSortModules(kernelModulesForTopoSort());
+}

package/dist/runtime/kernel-register-hooks.d.ts

@@ -0,0 +1,4 @@
+import type { CommerceConfig } from "../config/types.js";
+import { HookRegistry } from "../kernel/hooks/registry.js";
+export declare function registerConfiguredKernelHooks(config: CommerceConfig, hooks: HookRegistry): void;
+//# sourceMappingURL=kernel-register-hooks.d.ts.map

package/dist/runtime/kernel-register-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel-register-hooks.d.ts","sourceRoot":"","sources":["../../src/runtime/kernel-register-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAoB,MAAM,6BAA6B,CAAC;AAM7E,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,YAAY,GAClB,IAAI,CAoDN"}

package/dist/runtime/kernel-register-hooks.js

@@ -0,0 +1,46 @@
+import { deliverWebhooks } from "../modules/webhooks/hook.js";
+import { syncToSearchIndex } from "../modules/search/hooks.js";
+import { auditHooks } from "../modules/audit/hooks.js";
+import { sendOrderStatusEmail } from "../hooks/order-emails.js";
+export function registerConfiguredKernelHooks(config, hooks) {
+    for (const [entityType, entityConfig] of Object.entries(config.entities ?? {})) {
+        const entityHooks = entityConfig.hooks ?? {};
+        for (const [hookName, handlers] of Object.entries(entityHooks)) {
+            hooks.registerConfigHooks(`catalog.${entityType}.${hookName}`, handlers ?? []);
+        }
+    }
+    for (const [moduleName, moduleConfig] of [
+        ["cart", config.cart],
+        ["checkout", config.checkout],
+        ["orders", config.orders],
+        ["inventory", config.inventory],
+    ]) {
+        const hooksObject = moduleConfig?.hooks;
+        if (!hooksObject)
+            continue;
+        for (const [hookName, handlers] of Object.entries(hooksObject)) {
+            const normalizedHandlers = (Array.isArray(handlers) ? handlers : []);
+            hooks.registerConfigHooks(`${moduleName}.${hookName}`, normalizedHandlers);
+        }
+    }
+    hooks.append("orders.afterCreate", deliverWebhooks);
+    hooks.append("orders.afterStatusChange", deliverWebhooks);
+    hooks.append("orders.afterStatusChange", sendOrderStatusEmail);
+    hooks.append("catalog.afterCreate", deliverWebhooks);
+    hooks.append("catalog.afterUpdate", deliverWebhooks);
+    hooks.append("catalog.afterDelete", deliverWebhooks);
+    hooks.append("inventory.afterAdjust", deliverWebhooks);
+    hooks.append("customers.afterCreate", deliverWebhooks);
+    hooks.append("customers.afterUpdate", deliverWebhooks);
+    hooks.append("pricing.afterCreate", deliverWebhooks);
+    hooks.append("pricing.afterUpdate", deliverWebhooks);
+    hooks.append("promotions.afterCreate", deliverWebhooks);
+    hooks.append("promotions.afterUpdate", deliverWebhooks);
+    hooks.append("fulfillment.afterCreate", deliverWebhooks);
+    hooks.append("cart.afterAddItem", deliverWebhooks);
+    hooks.append("catalog.afterCreate", syncToSearchIndex);
+    hooks.append("catalog.afterUpdate", syncToSearchIndex);
+    for (const [key, handler] of Object.entries(auditHooks)) {
+        hooks.append(key, handler);
+    }
+}

package/dist/runtime/kernel-types.d.ts

@@ -0,0 +1,65 @@
+import type { CommerceConfig, PluginPermission } from "../config/types.js";
+import type { HookRegistry } from "../kernel/hooks/registry.js";
+import type { DatabaseAdapter } from "../kernel/database/adapter.js";
+import { CatalogServiceImpl } from "../modules/catalog/service.js";
+import { InventoryService } from "../modules/inventory/service.js";
+import { MediaService } from "../modules/media/service.js";
+import { CartService } from "../modules/cart/service.js";
+import { OrderService } from "../modules/orders/service.js";
+import { PaymentsService } from "../modules/payments/service.js";
+import { FulfillmentService } from "../modules/fulfillment/service.js";
+import { CustomerService } from "../modules/customers/service.js";
+import { WebhookService } from "../modules/webhooks/service.js";
+import { AnalyticsService } from "../modules/analytics/service.js";
+import { PricingService } from "../modules/pricing/service.js";
+import { PromotionService } from "../modules/promotions/service.js";
+import { TaxService } from "../modules/tax/service.js";
+import { ShippingService } from "../modules/shipping/service.js";
+import { SearchService } from "../modules/search/service.js";
+import type { AuditService } from "../modules/audit/service.js";
+import { OrganizationService } from "../modules/organization/service.js";
+import { createLogger } from "../utils/logger.js";
+import { CompensationFailuresRepository } from "../kernel/compensation/repository.js";
+export interface WebhookDeliveryPayload {
+    endpoint: {
+        id: string;
+        url: string;
+        secret: string;
+    };
+    eventName: string;
+    payload: unknown;
+}
+export interface Kernel {
+    config: CommerceConfig;
+    hooks: HookRegistry;
+    database: DatabaseAdapter;
+    services: {
+        catalog: CatalogServiceImpl;
+        inventory: InventoryService;
+        media: MediaService;
+        cart: CartService;
+        orders: OrderService;
+        payments: PaymentsService;
+        fulfillment: FulfillmentService;
+        customers: CustomerService;
+        webhooks: WebhookService & {
+            enqueueDelivery(payload: WebhookDeliveryPayload): Promise<void>;
+        };
+        analytics: AnalyticsService;
+        pricing: PricingService;
+        promotions: PromotionService;
+        tax: TaxService;
+        shipping: ShippingService;
+        search: SearchService;
+        audit: AuditService;
+        compensationFailures: CompensationFailuresRepository;
+        email: CommerceConfig["email"];
+        organization: OrganizationService;
+    };
+    pluginPermissions: PluginPermission[];
+    logger: ReturnType<typeof createLogger>;
+}
+export declare const KERNEL_REQUIRED_SERVICE_KEYS: ["catalog", "inventory", "media", "cart", "orders", "payments", "fulfillment", "customers", "webhooks", "analytics", "pricing", "promotions", "tax", "shipping", "search", "audit", "compensationFailures"];
+export declare function assertKernelServicesReady(services: Partial<Kernel["services"]>): asserts services is Kernel["services"];
+export declare function assertSortedBefore(topo: readonly string[], a: string, b: string): void;
+//# sourceMappingURL=kernel-types.d.ts.map

package/dist/runtime/kernel-types.d.ts.map

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

package/dist/runtime/kernel-types.js

@@ -0,0 +1,36 @@
+export const KERNEL_REQUIRED_SERVICE_KEYS = [
+    "catalog",
+    "inventory",
+    "media",
+    "cart",
+    "orders",
+    "payments",
+    "fulfillment",
+    "customers",
+    "webhooks",
+    "analytics",
+    "pricing",
+    "promotions",
+    "tax",
+    "shipping",
+    "search",
+    "audit",
+    "compensationFailures",
+];
+export function assertKernelServicesReady(services) {
+    for (const key of KERNEL_REQUIRED_SERVICE_KEYS) {
+        if (services[key] === undefined) {
+            throw new Error(`Kernel service "${String(key)}" was not initialized.`);
+        }
+    }
+}
+export function assertSortedBefore(topo, a, b) {
+    const ia = topo.indexOf(a);
+    const ib = topo.indexOf(b);
+    if (ia < 0 || ib < 0) {
+        throw new Error(`kernelModuleInstantiationOrder missing key: ${a} or ${b}`);
+    }
+    if (ia >= ib) {
+        throw new Error(`Invalid kernel topo order: expected "${a}" before "${b}" (indices ${ia}, ${ib})`);
+    }
+}

package/dist/runtime/kernel.d.ts

@@ -0,0 +1,6 @@
+import type { CommerceConfig } from "../config/types.js";
+import { type Kernel, type WebhookDeliveryPayload } from "./kernel-types.js";
+export type { Kernel, WebhookDeliveryPayload };
+export { KERNEL_ALL_MODULES, kernelModuleInstantiationOrder, } from "./kernel-modules.js";
+export declare function createKernel(config: CommerceConfig): Kernel;
+//# sourceMappingURL=kernel.d.ts.map

package/dist/runtime/kernel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel.d.ts","sourceRoot":"","sources":["../../src/runtime/kernel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAoBzD,OAAO,EAGL,KAAK,MAAM,EACX,KAAK,sBAAsB,EAC5B,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EAAE,MAAM,EAAE,sBAAsB,EAAE,CAAC;AAC/C,OAAO,EACL,kBAAkB,EAClB,8BAA8B,GAC/B,MAAM,qBAAqB,CAAC;AAE7B,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CA6H3D"}

package/dist/runtime/kernel.js

@@ -0,0 +1,113 @@
+import { HookRegistry } from "../kernel/hooks/registry.js";
+import { createDatabaseConnection } from "../kernel/database/adapter.js";
+import { topoSortModules } from "../kernel/module/index.js";
+import { WebhookDeliveryWorker } from "../modules/webhooks/worker.js";
+import { WebhooksRepository } from "../modules/webhooks/repository/index.js";
+import { createLogger } from "../utils/logger.js";
+import { withTiming } from "../kernel/service-timing.js";
+import { setBootDefaultOrgId } from "../auth/org.js";
+import { setBootStrictOrgResolution } from "../auth/strict-org-resolution.js";
+import { DrizzleJobsAdapter } from "../kernel/jobs/drizzle-adapter.js";
+import { CompensationFailuresRepository } from "../kernel/compensation/repository.js";
+import { KERNEL_ALL_MODULES, kernelModulesForTopoSort, } from "./kernel-modules.js";
+import { registerConfiguredKernelHooks } from "./kernel-register-hooks.js";
+import { assertKernelServicesReady, assertSortedBefore, } from "./kernel-types.js";
+export { KERNEL_ALL_MODULES, kernelModuleInstantiationOrder, } from "./kernel-modules.js";
+export function createKernel(config) {
+    const hooks = new HookRegistry();
+    const logger = createLogger("kernel");
+    hooks.setLogger({ error: (obj, msg) => logger.error(msg, obj) });
+    // Apply boot-time org resolution settings from config. Previously only
+    // createCommerce did this, which meant tests calling createKernel directly
+    // had services fall back to DEFAULT_ORG_ID with a deprecation warning even
+    // when config.auth.defaultOrganizationId was set.
+    setBootStrictOrgResolution(config.auth?.strictOrgResolution === true);
+    if (config.auth?.defaultOrganizationId) {
+        setBootDefaultOrgId(config.auth.defaultOrganizationId);
+    }
+    if (!config.storage) {
+        throw new Error("Storage adapter is required. Configure `storage` in defineConfig (for example: localStorageAdapter for development, or s3StorageAdapter/r2StorageAdapter for object storage).");
+    }
+    const database = createDatabaseConnection({
+        adapter: config.databaseAdapter ?? {
+            provider: config.database.provider,
+            db: {},
+            async transaction(fn) {
+                return fn({});
+            },
+        },
+    });
+    const services = {
+        email: config.email,
+    };
+    const serviceContainer = services;
+    serviceContainer.database = database;
+    const db = database.db;
+    const jobsTaskMap = new Map((config.jobs?.tasks ?? []).map((t) => [t.slug, t]));
+    const jobsAdapter = new DrizzleJobsAdapter(db, jobsTaskMap);
+    serviceContainer.jobs = jobsAdapter;
+    const topoGraph = kernelModulesForTopoSort();
+    const order = topoSortModules(topoGraph);
+    const moduleKeys = Object.keys(KERNEL_ALL_MODULES);
+    if (order.length !== moduleKeys.length) {
+        throw new Error(`topoSortModules length mismatch: got ${order.length}, expected ${moduleKeys.length}`);
+    }
+    assertSortedBefore(order, "catalog", "inventory");
+    assertSortedBefore(order, "catalog", "pricing");
+    const moduleDeps = {
+        db: database,
+        hooks,
+        config,
+        logger,
+    };
+    for (const id of order) {
+        const mod = KERNEL_ALL_MODULES[id];
+        const svc = mod.service({
+            ...moduleDeps,
+            services: services,
+        });
+        services[id] = svc;
+    }
+    const baseWebhooks = services.webhooks;
+    const webhookWorker = new WebhookDeliveryWorker({
+        repository: new WebhooksRepository(db),
+    });
+    services.webhooks = Object.assign(baseWebhooks, {
+        async enqueueDelivery(payload) {
+            await webhookWorker.deliver(payload);
+        },
+    });
+    services.compensationFailures = new CompensationFailuresRepository(db);
+    assertKernelServicesReady(services);
+    if (process.env.NODE_ENV !== "test") {
+        const timedLogger = {
+            info: (obj, msg) => logger.info(msg, obj),
+            error: (obj, msg) => logger.error(msg, obj),
+        };
+        const serviceKeys = Object.keys(services);
+        for (const key of serviceKeys) {
+            const svc = services[key];
+            if (svc && typeof svc === "object" && key !== "email") {
+                services[key] = withTiming(svc, key, timedLogger);
+            }
+        }
+    }
+    registerConfiguredKernelHooks(config, hooks);
+    const kernel = {
+        config,
+        hooks,
+        database,
+        services,
+        pluginPermissions: [...(config.pluginPermissions ?? [])],
+        logger,
+    };
+    for (const [key, handlers] of Object.entries(config.hooks ?? {})) {
+        for (const handler of handlers) {
+            hooks.append(key, handler);
+        }
+    }
+    for (const model of config.analytics?.models ?? []) {
+        services.analytics.registerModel(model);
+    }
+    return kernel;
+}

package/dist/runtime/logger.d.ts

@@ -0,0 +1,11 @@
+import pino from "pino";
+import type { CommerceConfig } from "../config/types.js";
+export type Logger = pino.Logger;
+/**
+ * Create a structured JSON logger for the commerce engine.
+ *
+ * Automatically redacts sensitive fields (authorization, password, token, etc.)
+ * from all log output. Uses Pino for high-performance, newline-delimited JSON.
+ */
+export declare function createLogger(config: CommerceConfig): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/runtime/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/runtime/logger.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;AAEjC;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAwB3D"}

package/dist/runtime/logger.js

@@ -0,0 +1,32 @@
+import pino from "pino";
+/**
+ * Create a structured JSON logger for the commerce engine.
+ *
+ * Automatically redacts sensitive fields (authorization, password, token, etc.)
+ * from all log output. Uses Pino for high-performance, newline-delimited JSON.
+ */
+export function createLogger(config) {
+    return pino({
+        level: config.logLevel ?? "info",
+        redact: {
+            paths: [
+                "req.headers.authorization",
+                "req.headers.cookie",
+                "*.password",
+                "*.secret",
+                "*.apiKey",
+                "*.creditCard",
+                "*.token",
+                "*.apiToken",
+            ],
+            censor: "[REDACTED]",
+        },
+        serializers: {
+            req: pino.stdSerializers.req,
+            err: pino.stdSerializers.err,
+        },
+        formatters: {
+            level: (label) => ({ level: label }),
+        },
+    });
+}

package/dist/runtime/server.d.ts

@@ -0,0 +1,37 @@
+import { OpenAPIHono } from "@hono/zod-openapi";
+import type { Actor } from "../auth/types.js";
+import type { AuthInstance } from "../auth/setup.js";
+import type { CommerceConfig } from "../config/types.js";
+import { type Logger } from "./logger.js";
+import { type CommerceInstance } from "./commerce.js";
+type ServerEnv = {
+    Variables: {
+        auth: AuthInstance;
+        actor: Actor | null;
+        requestId: string;
+        logger: Logger;
+    };
+};
+/**
+ * Returns true if running in a Node-like runtime that supports
+ * `process.on()` + `process.exit()`. Edge runtimes (Cloudflare Workers,
+ * Vercel Edge) return false — caller should skip process-crash handlers
+ * and defer unhandled errors to the platform.
+ *
+ * Exposed for direct unit testing — see test/server-edge-runtime.test.ts.
+ */
+export declare function isNodeRuntime(): boolean;
+/**
+ * Create a full HTTP server (Hono) with all REST routes, auth, and middleware.
+ *
+ * For server-side frameworks (Next.js, TanStack Start, SvelteKit), use
+ * `createCommerce()` instead — it gives you a local API without HTTP overhead.
+ */
+export declare function createServer(config: CommerceConfig): Promise<{
+    app: OpenAPIHono<ServerEnv, {}, "/">;
+    kernel: import("./kernel-types.js").Kernel;
+    logger: Logger;
+    commerce: CommerceInstance;
+}>;
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/runtime/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/runtime/server.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAMhD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAMzD,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAExD,OAAO,EAAkB,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAItE,KAAK,SAAS,GAAG;IACf,SAAS,EAAE;QACT,IAAI,EAAE,YAAY,CAAC;QACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAMvC;AAeD;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,cAAc;;;;;GAoZxD"}