@porulle/core 0.1.0

package/dist/test-utils/rest-api-test-utils.js

@@ -0,0 +1,208 @@
+/**
+ * Integration test utilities for REST API endpoints.
+ *
+ * Provides helper functions to test Hono routes with a real kernel,
+ * PGlite database, and authentication middleware.
+ */
+import { Hono } from "hono";
+import { createKernel } from "../runtime/kernel.js";
+import { createAuth } from "../auth/setup.js";
+import { authMiddleware } from "../auth/middleware.js";
+import { createRestRoutes } from "../interfaces/rest/index.js";
+import { createPGliteTestConfig } from "./create-test-config.js";
+import { CommerceValidationError } from "../kernel/errors.js";
+import { Ok, Err } from "../kernel/result.js";
+const mockPaymentAdapter = {
+    providerId: "test-payments",
+    async createPaymentIntent(params) {
+        return Ok({
+            id: "pi_test_" + Date.now(),
+            status: "requires_capture",
+            amount: params.amount,
+            currency: params.currency,
+            clientSecret: "secret_test",
+        });
+    },
+    async capturePayment() {
+        return Ok({ id: "pi_test_" + Date.now(), status: "succeeded", amountCaptured: 1000 });
+    },
+    async refundPayment() {
+        return Ok({ id: "re_test_" + Date.now(), status: "succeeded", amountRefunded: 1000 });
+    },
+    async cancelPaymentIntent() {
+        return Ok(undefined);
+    },
+    async verifyWebhook(request) {
+        // Extract signature from headers
+        const signature = request.headers.get("stripe-signature") || request.headers.get("webhook-signature");
+        // Extract payload from request body
+        let payload;
+        try {
+            payload = await request.clone().json();
+        }
+        catch {
+            return Err(new CommerceValidationError("Webhook payload is invalid or missing"));
+        }
+        // Simulate signature verification for production-hardened testing
+        // Reject invalid signatures like "invalid_signature"
+        if (signature === "invalid_signature") {
+            return Err(new CommerceValidationError("Invalid webhook signature"));
+        }
+        // Reject requests with no required fields
+        if (!payload || !payload.type) {
+            return Err(new CommerceValidationError("Webhook payload is missing required fields"));
+        }
+        return Ok({ id: "evt_test_" + Date.now(), type: String(payload.type), data: (payload.data ?? {}) });
+    },
+};
+/**
+ * Creates a test server with PGlite-backed kernel for REST API testing.
+ */
+export async function createTestServer(overrides = {}) {
+    const { config, cleanup } = await createPGliteTestConfig({
+        payments: [mockPaymentAdapter],
+        ...overrides,
+    });
+    const kernel = createKernel(config);
+    const auth = createAuth(kernel.database, config);
+    const app = new Hono();
+    // Set auth in context (like createServer does)
+    app.use("*", async (c, next) => {
+        c.set("auth", auth);
+        await next();
+    });
+    // Test middleware: allow direct actor injection via x-test-actor header for testing
+    app.use("*", async (c, next) => {
+        const testActorHeader = c.req.header("x-test-actor");
+        if (testActorHeader) {
+            try {
+                const actor = JSON.parse(testActorHeader);
+                c.set("actor", actor);
+                await next();
+                return;
+            }
+            catch {
+                // Invalid JSON, continue to auth middleware
+            }
+        }
+        await next();
+    });
+    // Add auth middleware
+    app.use("*", authMiddleware(auth, config));
+    // Error handling middleware - catch thrown errors and convert to JSON
+    app.use("*", async (c, next) => {
+        try {
+            await next();
+        }
+        catch (error) {
+            // Import error handling utilities
+            const { mapErrorToResponse, mapErrorToStatus } = await import("../interfaces/rest/utils.js");
+            return c.json(mapErrorToResponse(error), mapErrorToStatus(error));
+        }
+    });
+    // Add REST routes
+    app.route("/api", createRestRoutes(kernel));
+    return { server: app, kernel, auth, cleanup };
+}
+/**
+ * Helper to parse JSON response from Hono Response
+ */
+export async function parseJsonResponse(response) {
+    return response.json();
+}
+/**
+ * Common test actor with staff permissions
+ */
+export const testActor = {
+    type: "user",
+    userId: "00000000-0000-0000-0000-000000000001",
+    email: "test@example.com",
+    name: "Test Staff",
+    vendorId: null,
+    organizationId: "org_default",
+    role: "staff",
+    permissions: [
+        "catalog:create",
+        "catalog:update",
+        "catalog:read",
+        "inventory:adjust",
+        "inventory:read",
+        "orders:create",
+        "orders:read",
+        "orders:update",
+        "cart:create",
+        "cart:update",
+        "cart:read",
+        "customers:update:self",
+        "webhooks:manage",
+        "pricing:manage",
+        "promotions:manage",
+        "promotions:read",
+        "audit:read",
+        "media:write",
+        "compensation:admin",
+    ],
+};
+/**
+ * Test actor with read-only permissions
+ */
+export const readonlyActor = {
+    type: "user",
+    userId: "00000000-0000-0000-0000-000000000002",
+    email: "readonly@example.com",
+    name: "Read Only User",
+    vendorId: null,
+    organizationId: "org_default",
+    role: "customer",
+    permissions: ["catalog:read", "cart:read", "orders:read:own"],
+};
+/**
+ * Test actor with no permissions
+ */
+export const noPermActor = {
+    type: "user",
+    userId: "00000000-0000-0000-0000-000000000003",
+    email: "noperm@example.com",
+    name: "No Perm",
+    vendorId: null,
+    organizationId: "org_default",
+    role: "customer",
+    permissions: [],
+};
+/**
+ * Helper to create a mock request with actor context
+ */
+export function createMockRequest(server, options) {
+    const url = new URL(options.url, "http://localhost");
+    const headers = {
+        "content-type": "application/json",
+        ...options.headers,
+    };
+    // Add actor as header for test middleware
+    if (options.actor) {
+        headers["x-test-actor"] = JSON.stringify(options.actor);
+    }
+    // Build the request
+    const requestInit = {
+        method: options.method,
+        headers,
+    };
+    if (options.body) {
+        requestInit.body = JSON.stringify(options.body);
+    }
+    const request = new Request(url, requestInit);
+    return request;
+}
+/**
+ * Helper to make authenticated requests to the test server
+ */
+export async function makeRequest(server, options) {
+    // Create request with actor header (defaults to testActor)
+    const request = createMockRequest(server, {
+        ...options,
+        actor: options.actor ?? testActor,
+    });
+    // Route the request through Hono
+    const response = await server.fetch(request);
+    return response;
+}

package/dist/test-utils/test-actors.d.ts

@@ -0,0 +1,21 @@
+import type { Actor } from "../auth/types.js";
+/**
+ * Organization ID used in test fixtures. Tests use the deprecated DEFAULT_ORG_ID
+ * because ensureDefaultOrg() creates this org in test setup. When RFC-060 Phase 6
+ * removes DEFAULT_ORG_ID, test setup will create a real org via Better Auth API.
+ */
+export declare const TEST_ORG_ID = "org_default";
+/** Admin with wildcard permissions. Use for setup operations in beforeAll. */
+export declare const testAdminActor: Actor;
+/** Staff with common operational permissions. */
+export declare const testStaffActor: Actor;
+/** Customer with minimal read/write-own permissions. */
+export declare const testCustomerActor: Actor;
+/** Actor with zero permissions. Use for negative auth/perm tests. */
+export declare const testNoPermActor: Actor;
+/**
+ * Builds request headers with optional test actor injection.
+ * The x-test-actor header is parsed by createPluginTestApp's middleware.
+ */
+export declare function jsonHeaders(actor?: Actor): Record<string, string>;
+//# sourceMappingURL=test-actors.d.ts.map

package/dist/test-utils/test-actors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-actors.d.ts","sourceRoot":"","sources":["../../src/test-utils/test-actors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAG9C;;;;GAIG;AACH,eAAO,MAAM,WAAW,gBAAiB,CAAC;AAE1C,8EAA8E;AAC9E,eAAO,MAAM,cAAc,EAAE,KAS5B,CAAC;AAEF,iDAAiD;AACjD,eAAO,MAAM,cAAc,EAAE,KAY5B,CAAC;AAEF,wDAAwD;AACxD,eAAO,MAAM,iBAAiB,EAAE,KAS/B,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,eAAe,EAAE,KAS7B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAIjE"}

package/dist/test-utils/test-actors.js

@@ -0,0 +1,64 @@
+import { DEFAULT_ORG_ID } from "../auth/org.js";
+/**
+ * Organization ID used in test fixtures. Tests use the deprecated DEFAULT_ORG_ID
+ * because ensureDefaultOrg() creates this org in test setup. When RFC-060 Phase 6
+ * removes DEFAULT_ORG_ID, test setup will create a real org via Better Auth API.
+ */
+export const TEST_ORG_ID = DEFAULT_ORG_ID;
+/** Admin with wildcard permissions. Use for setup operations in beforeAll. */
+export const testAdminActor = {
+    type: "user",
+    userId: "test-admin-1",
+    email: "admin@test.local",
+    name: "Test Admin",
+    vendorId: null,
+    organizationId: TEST_ORG_ID,
+    role: "admin",
+    permissions: ["*:*"],
+};
+/** Staff with common operational permissions. */
+export const testStaffActor = {
+    type: "user",
+    userId: "test-staff-1",
+    email: "staff@test.local",
+    name: "Test Staff",
+    vendorId: null,
+    organizationId: TEST_ORG_ID,
+    role: "staff",
+    permissions: [
+        "catalog:read", "catalog:create", "catalog:update",
+        "inventory:adjust", "orders:read", "orders:create", "orders:update",
+    ],
+};
+/** Customer with minimal read/write-own permissions. */
+export const testCustomerActor = {
+    type: "user",
+    userId: "test-customer-1",
+    email: "customer@test.local",
+    name: "Test Customer",
+    vendorId: null,
+    organizationId: TEST_ORG_ID,
+    role: "customer",
+    permissions: ["catalog:read", "cart:create", "cart:read", "orders:read:own"],
+};
+/** Actor with zero permissions. Use for negative auth/perm tests. */
+export const testNoPermActor = {
+    type: "user",
+    userId: "test-noperm-1",
+    email: "noperm@test.local",
+    name: "No Permissions",
+    vendorId: null,
+    organizationId: TEST_ORG_ID,
+    role: "customer",
+    permissions: [],
+};
+/**
+ * Builds request headers with optional test actor injection.
+ * The x-test-actor header is parsed by createPluginTestApp's middleware.
+ */
+export function jsonHeaders(actor) {
+    const headers = { "Content-Type": "application/json" };
+    if (actor)
+        headers["x-test-actor"] = JSON.stringify(actor);
+    return headers;
+}

package/dist/test-utils/typed-hooks.d.ts

@@ -0,0 +1,44 @@
+import type { PluginHookRegistration } from "../kernel/plugin/manifest.js";
+import type { HookContext, HookOperation } from "../kernel/hooks/types.js";
+/**
+ * Creates a typed before-hook registration for plugins.
+ *
+ * Narrows the handler signature from the loose `(...args: unknown[]) => unknown`
+ * on PluginHookRegistration to the actual `{ data, operation, context }` shape,
+ * providing autocomplete on context.jobs.enqueue(), context.logger.info(), etc.
+ *
+ * @example
+ * ```typescript
+ * hooks: () => [
+ *   beforeHook<{ customerId: string }>("orders.beforeCreate", async ({ data, context }) => {
+ *     context.logger.info("order_creating", { customerId: data.customerId });
+ *     return data;
+ *   }),
+ * ],
+ * ```
+ */
+export declare function beforeHook<TData>(key: string, handler: (args: {
+    data: TData;
+    operation: HookOperation;
+    context: HookContext;
+}) => Promise<TData> | TData): PluginHookRegistration;
+/**
+ * Creates a typed after-hook registration for plugins.
+ *
+ * @example
+ * ```typescript
+ * import { resolveOrgId } from "@porulle/core";
+ * hooks: () => [
+ *   afterHook<{ id: string; grandTotal: number }>("orders.afterCreate", async ({ result, context }) => {
+ *     await context.jobs.enqueue("loyalty:award-points", { orderId: result.id }, { organizationId: resolveOrgId(context.actor) });
+ *   }),
+ * ],
+ * ```
+ */
+export declare function afterHook<TData>(key: string, handler: (args: {
+    data: TData | null;
+    result: TData;
+    operation: HookOperation;
+    context: HookContext;
+}) => Promise<void> | void): PluginHookRegistration;
+//# sourceMappingURL=typed-hooks.d.ts.map

package/dist/test-utils/typed-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-hooks.d.ts","sourceRoot":"","sources":["../../src/test-utils/typed-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE3E;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAC9B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,CAAC,IAAI,EAAE;IACd,IAAI,EAAE,KAAK,CAAC;IACZ,SAAS,EAAE,aAAa,CAAC;IACzB,OAAO,EAAE,WAAW,CAAC;CACtB,KAAK,OAAO,CAAC,KAAK,CAAC,GAAG,KAAK,GAC3B,sBAAsB,CAExB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAC7B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,CAAC,IAAI,EAAE;IACd,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC;IACnB,MAAM,EAAE,KAAK,CAAC;IACd,SAAS,EAAE,aAAa,CAAC;IACzB,OAAO,EAAE,WAAW,CAAC;CACtB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GACzB,sBAAsB,CAExB"}

package/dist/test-utils/typed-hooks.js

@@ -0,0 +1,36 @@
+/**
+ * Creates a typed before-hook registration for plugins.
+ *
+ * Narrows the handler signature from the loose `(...args: unknown[]) => unknown`
+ * on PluginHookRegistration to the actual `{ data, operation, context }` shape,
+ * providing autocomplete on context.jobs.enqueue(), context.logger.info(), etc.
+ *
+ * @example
+ * ```typescript
+ * hooks: () => [
+ *   beforeHook<{ customerId: string }>("orders.beforeCreate", async ({ data, context }) => {
+ *     context.logger.info("order_creating", { customerId: data.customerId });
+ *     return data;
+ *   }),
+ * ],
+ * ```
+ */
+export function beforeHook(key, handler) {
+    return { key, handler: handler };
+}
+/**
+ * Creates a typed after-hook registration for plugins.
+ *
+ * @example
+ * ```typescript
+ * import { resolveOrgId } from "@porulle/core";
+ * hooks: () => [
+ *   afterHook<{ id: string; grandTotal: number }>("orders.afterCreate", async ({ result, context }) => {
+ *     await context.jobs.enqueue("loyalty:award-points", { orderId: result.id }, { organizationId: resolveOrgId(context.actor) });
+ *   }),
+ * ],
+ * ```
+ */
+export function afterHook(key, handler) {
+    return { key, handler: handler };
+}

package/dist/testing.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Test utilities for UnifiedCommerce plugins and apps.
+ *
+ * Import from "@porulle/core/testing" — NOT from "@porulle/core".
+ * This sub-path is isolated from the main barrel to avoid pulling drizzle-kit,
+ * tsx, esbuild, and other heavy dev-only deps into bundlers like Turbopack.
+ */
+export { createTestKernel } from "./test-utils/create-test-kernel.js";
+export { createTestPluginContext } from "./test-utils/create-test-plugin-context.js";
+export { createRepositoryTestHarness } from "./test-utils/create-repository-test-harness.js";
+export { createPluginTestApp, type PluginTestApp, type TestAppEnv } from "./test-utils/create-plugin-test-app.js";
+export { TEST_ORG_ID, testAdminActor, testStaffActor, testCustomerActor, testNoPermActor, jsonHeaders, } from "./test-utils/test-actors.js";
+export { beforeHook, afterHook } from "./test-utils/typed-hooks.js";
+export type { Actor } from "./auth/types.js";
+//# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AACrF,OAAO,EAAE,2BAA2B,EAAE,MAAM,gDAAgD,CAAC;AAC7F,OAAO,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,wCAAwC,CAAC;AAClH,OAAO,EACL,WAAW,EACX,cAAc,EAAE,cAAc,EAAE,iBAAiB,EAAE,eAAe,EAClE,WAAW,GACZ,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAGpE,YAAY,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/testing.js

@@ -0,0 +1,13 @@
+/**
+ * Test utilities for UnifiedCommerce plugins and apps.
+ *
+ * Import from "@porulle/core/testing" — NOT from "@porulle/core".
+ * This sub-path is isolated from the main barrel to avoid pulling drizzle-kit,
+ * tsx, esbuild, and other heavy dev-only deps into bundlers like Turbopack.
+ */
+export { createTestKernel } from "./test-utils/create-test-kernel.js";
+export { createTestPluginContext } from "./test-utils/create-test-plugin-context.js";
+export { createRepositoryTestHarness } from "./test-utils/create-repository-test-harness.js";
+export { createPluginTestApp } from "./test-utils/create-plugin-test-app.js";
+export { TEST_ORG_ID, testAdminActor, testStaffActor, testCustomerActor, testNoPermActor, jsonHeaders, } from "./test-utils/test-actors.js";
+export { beforeHook, afterHook } from "./test-utils/typed-hooks.js";

package/dist/types/commerce-types.d.ts

@@ -0,0 +1,34 @@
+import type { sellableEntities } from "../modules/catalog/schema.js";
+import type { orders } from "../modules/orders/schema.js";
+import type { carts } from "../modules/cart/schema.js";
+import type { customers } from "../modules/customers/schema.js";
+import type { inventoryLevels } from "../modules/inventory/schema.js";
+/**
+ * Central type map for all commerce entities.
+ *
+ * Plugins can augment this interface via TypeScript module augmentation:
+ *
+ * ```typescript
+ * declare module "@porulle/core" {
+ *   interface CommerceModuleTypes {
+ *     LoyaltyPoints: {
+ *       id: string;
+ *       customerId: string;
+ *       points: number;
+ *       tier: "bronze" | "silver" | "gold";
+ *     };
+ *   }
+ * }
+ * ```
+ *
+ * This enables plugin types to be referenced without importing
+ * internal schema modules.
+ */
+export interface CommerceModuleTypes {
+    Product: typeof sellableEntities.$inferSelect;
+    Order: typeof orders.$inferSelect;
+    Cart: typeof carts.$inferSelect;
+    Customer: typeof customers.$inferSelect;
+    InventoryLevel: typeof inventoryLevels.$inferSelect;
+}
+//# sourceMappingURL=commerce-types.d.ts.map

package/dist/types/commerce-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commerce-types.d.ts","sourceRoot":"","sources":["../../src/types/commerce-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEtE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,gBAAgB,CAAC,YAAY,CAAC;IAC9C,KAAK,EAAE,OAAO,MAAM,CAAC,YAAY,CAAC;IAClC,IAAI,EAAE,OAAO,KAAK,CAAC,YAAY,CAAC;IAChC,QAAQ,EAAE,OAAO,SAAS,CAAC,YAAY,CAAC;IACxC,cAAc,EAAE,OAAO,eAAe,CAAC,YAAY,CAAC;CACrD"}

package/dist/types/commerce-types.js

@@ -0,0 +1 @@
+export {};

package/dist/utils/agent-prompt.d.ts

@@ -0,0 +1,2 @@
+export declare const COMMERCE_AGENT_SYSTEM_PROMPT = "You are an AI commerce assistant with access to a live e-commerce store via the UnifiedCommerce Engine REST API.\n\nYour role:\n- Help users browse products, place orders, and answer commerce questions\n- Use structured tool outputs and summarize clearly\n- Be accurate, concise, and transparent about limitations\n\nGuidelines:\n- Prefer factual responses grounded in API data\n- Ask for clarification when requests are ambiguous\n- Never invent order, inventory, or payment state\n- Protect sensitive information and follow least-privilege access";
+//# sourceMappingURL=agent-prompt.d.ts.map

package/dist/utils/agent-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-prompt.d.ts","sourceRoot":"","sources":["../../src/utils/agent-prompt.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,4BAA4B,yiBAWyB,CAAC"}

package/dist/utils/agent-prompt.js

@@ -0,0 +1,12 @@
+export const COMMERCE_AGENT_SYSTEM_PROMPT = `You are an AI commerce assistant with access to a live e-commerce store via the UnifiedCommerce Engine REST API.
+
+Your role:
+- Help users browse products, place orders, and answer commerce questions
+- Use structured tool outputs and summarize clearly
+- Be accurate, concise, and transparent about limitations
+
+Guidelines:
+- Prefer factual responses grounded in API data
+- Ask for clarification when requests are ambiguous
+- Never invent order, inventory, or payment state
+- Protect sensitive information and follow least-privilege access`;

package/dist/utils/id.d.ts

@@ -0,0 +1,2 @@
+export declare function makeId(): string;
+//# sourceMappingURL=id.d.ts.map

package/dist/utils/id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AAAA,wBAAgB,MAAM,IAAI,MAAM,CAE/B"}

package/dist/utils/id.js

@@ -0,0 +1,3 @@
+export function makeId() {
+    return crypto.randomUUID();
+}

package/dist/utils/logger.d.ts

@@ -0,0 +1,3 @@
+import type { Logger } from "../kernel/hooks/types.js";
+export declare function createLogger(scope: string): Logger;
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAEvD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAelD"}

package/dist/utils/logger.js

@@ -0,0 +1,16 @@
+export function createLogger(scope) {
+    return {
+        info(message, data) {
+            // eslint-disable-next-line no-console
+            console.info(`[${scope}] ${message}`, data ?? "");
+        },
+        warn(message, data) {
+            // eslint-disable-next-line no-console
+            console.warn(`[${scope}] ${message}`, data ?? "");
+        },
+        error(message, data) {
+            // eslint-disable-next-line no-console
+            console.error(`[${scope}] ${message}`, data ?? "");
+        },
+    };
+}

package/dist/utils/pagination.d.ts

@@ -0,0 +1,11 @@
+export interface Pagination {
+    page: number;
+    limit: number;
+    total: number;
+    totalPages: number;
+}
+export declare function paginate<T>(items: T[], page: number, limit: number): {
+    items: T[];
+    pagination: Pagination;
+};
+//# sourceMappingURL=pagination.d.ts.map

package/dist/utils/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../src/utils/pagination.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IAAC,UAAU,EAAE,UAAU,CAAA;CAAE,CAc3G"}

package/dist/utils/pagination.js

@@ -0,0 +1,15 @@
+export function paginate(items, page, limit) {
+    const safeLimit = Math.max(1, limit);
+    const safePage = Math.max(1, page);
+    const start = (safePage - 1) * safeLimit;
+    const sliced = items.slice(start, start + safeLimit);
+    return {
+        items: sliced,
+        pagination: {
+            page: safePage,
+            limit: safeLimit,
+            total: items.length,
+            totalPages: Math.max(1, Math.ceil(items.length / safeLimit)),
+        },
+    };
+}

package/package.json

@@ -0,0 +1,89 @@
+{
+  "name": "@porulle/core",
+  "version": "0.1.0",
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "bun": "./src/index.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "types": "./src/index.ts"
+    },
+    "./schema": {
+      "bun": "./src/kernel/database/schema.ts",
+      "import": "./dist/kernel/database/schema.js",
+      "require": "./dist/kernel/database/schema.js",
+      "types": "./src/kernel/database/schema.ts"
+    },
+    "./auth-schema": {
+      "bun": "./src/auth/auth-schema.ts",
+      "import": "./dist/auth/auth-schema.js",
+      "require": "./dist/auth/auth-schema.js",
+      "types": "./src/auth/auth-schema.ts"
+    },
+    "./testing": {
+      "bun": "./src/testing.ts",
+      "import": "./dist/testing.js",
+      "require": "./dist/testing.js",
+      "types": "./src/testing.ts"
+    },
+    "./drizzle": {
+      "bun": "./src/drizzle.ts",
+      "import": "./dist/drizzle.js",
+      "require": "./dist/drizzle.js",
+      "types": "./src/drizzle.ts"
+    }
+  },
+  "scripts": {
+    "generate:plugins": "node ./scripts/generate-plugin-types.mjs",
+    "check:store-guard": "node ./scripts/check-store-guard.mjs",
+    "build": "rm -rf dist tsconfig.build.tsbuildinfo && npm run generate:plugins && npm run check:store-guard && tsc -p tsconfig.build.json",
+    "check-types": "npm run generate:plugins && npm run check:store-guard && tsc --noEmit",
+    "lint": "eslint . --max-warnings 1000",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@better-auth/drizzle-adapter": "^1.3.8",
+    "@hono/zod-openapi": "^1.2.2",
+    "@scalar/hono-api-reference": "^0.10.5",
+    "better-auth": "^1.3.8",
+    "drizzle-orm": "^0.45.1",
+    "drizzle-zod": "^0.8.3",
+    "hono": "^4.9.8",
+    "hono-rate-limiter": "^0.5.3",
+    "pino": "^10.3.1",
+    "zod": "^4.1.11"
+  },
+  "devDependencies": {
+    "@better-auth/api-key": "^1.5.4",
+    "@electric-sql/pglite": "^0.3.15",
+    "@repo/eslint-config": "*",
+    "@repo/typescript-config": "*",
+    "@types/node": "^25.5.0",
+    "@vitest/coverage-v8": "^3.2.4",
+    "drizzle-kit": "^0.31.9",
+    "eslint": "^9.39.1",
+    "typescript": "5.9.2",
+    "vitest": "^3.2.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "src",
+    "dist",
+    "README.md"
+  ],
+  "description": "The kernel — services, adapters, hooks, state machines, auth, runtime. Everything else in the monorepo composes on top of it.",
+  "homepage": "https://porulle-docs.vercel.app",
+  "bugs": {
+    "url": "https://github.com/asyncdotengineering/porulle/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/asyncdotengineering/porulle.git",
+    "directory": "packages/core"
+  },
+  "author": "Porulle contributors"
+}