@walkeros/server-destination-sqlite 3.4.0-next-1776749829492

package/README.md

@@ -0,0 +1,132 @@
+# @walkeros/server-destination-sqlite
+
+Server-side SQLite destination for
+[walkerOS](https://github.com/elbwalker/walkerOS). Writes events to a local
+SQLite file (via `better-sqlite3`) or a remote Turso / libSQL / sqld database
+(via `@libsql/client`). Driver is auto-selected from the connection URL. Both
+SDKs are optional peer dependencies -- install only what you need.
+
+## Installation
+
+```bash
+npm install @walkeros/server-destination-sqlite better-sqlite3
+# or for remote Turso / libSQL
+npm install @walkeros/server-destination-sqlite @libsql/client
+```
+
+## Quick Start
+
+Local file:
+
+```json
+{
+  "destinations": {
+    "sqlite": {
+      "package": "@walkeros/server-destination-sqlite",
+      "config": {
+        "settings": {
+          "sqlite": {
+            "url": "./events.db"
+          }
+        }
+      }
+    }
+  }
+}
+```
+
+Remote Turso:
+
+```json
+{
+  "destinations": {
+    "sqlite": {
+      "package": "@walkeros/server-destination-sqlite",
+      "config": {
+        "settings": {
+          "sqlite": {
+            "url": "libsql://my-db.turso.io",
+            "authToken": "$env.TURSO_TOKEN"
+          }
+        }
+      }
+    }
+  }
+}
+```
+
+## Settings
+
+| Setting            | Type                 | Required | Default  | Description                                                                                                                                    |
+| ------------------ | -------------------- | -------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
+| `sqlite.url`       | `string`             | Yes      | --       | Connection URL. `libsql://`, `http(s)://`, `ws(s)://` route to libSQL. Anything else is treated as a local file. Use `:memory:` for in-memory. |
+| `sqlite.authToken` | `string`             | No       | --       | libSQL / Turso auth token. Ignored for local.                                                                                                  |
+| `sqlite.table`     | `string`             | No       | `events` | Target table name.                                                                                                                             |
+| `sqlite.schema`    | `'auto' \| 'manual'` | No       | `'auto'` | `auto` runs `CREATE TABLE IF NOT EXISTS` on init. `manual` skips creation (bring your own schema + mapping).                                   |
+
+## Per-rule mapping overrides
+
+| Setting                  | Type     | Description                          |
+| ------------------------ | -------- | ------------------------------------ |
+| `mapping.settings.table` | `string` | Override target table for this rule. |
+
+## Auto Schema
+
+With `schema: 'auto'` (the default), the first `init()` runs:
+
+```sql
+CREATE TABLE IF NOT EXISTS events (
+  id           INTEGER PRIMARY KEY AUTOINCREMENT,
+  created_at   TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  timestamp    INTEGER,
+  event_id     TEXT,
+  name         TEXT,
+  entity       TEXT,
+  action       TEXT,
+  session_id   TEXT,
+  user_id      TEXT,
+  page_url     TEXT,
+  page_title   TEXT,
+  referrer_url TEXT,
+  data         TEXT,
+  globals      TEXT,
+  consent      TEXT
+)
+```
+
+Nested JSON fields (`data`, `globals`, `consent`) are stored as JSON strings.
+`page_url` comes from `source.id`; `page_title` from `data.title`;
+`referrer_url` from `source.previous_id`.
+
+## Drivers
+
+- **Local** (`better-sqlite3`): sync native driver, ideal for single-host
+  deployments. URL is treated as a filesystem path. `:memory:` works too.
+- **Remote** (`@libsql/client`): async HTTP/WSS driver for Turso, sqld, or
+  self-hosted libSQL. Auth via `authToken`.
+
+Both are peer dependencies. The destination picks the driver at `init()` time
+based on the URL prefix.
+
+## Shutdown
+
+The destination calls `close()` on the connection during `destroy()`.
+User-provided clients (wired in via `env.client` or `settings.sqlite._client`)
+are not closed.
+
+## Limitations
+
+- v1 issues one `INSERT` per event. A `pushBatch` path is planned for v2.
+- Connection death is not auto-retried. A fatal driver error logs and drops
+  events until the flow restarts.
+- `schema: 'manual'` skips `CREATE TABLE` but still uses the canonical column
+  layout for the prepared INSERT. If your custom table has a different shape,
+  also provide a mapping that produces matching args.
+
+## Type Definitions
+
+See [src/types/index.ts](./src/types/index.ts).
+
+## License
+
+MIT.

package/dist/dev.d.mts

@@ -0,0 +1,158 @@
+import * as _walkeros_core_dev from '@walkeros/core/dev';
+import { z } from '@walkeros/core/dev';
+import { DestinationServer } from '@walkeros/server-core';
+import { Flow } from '@walkeros/core';
+
+declare const SqliteSettingsSchema: z.ZodObject<{
+    url: z.ZodString;
+    authToken: z.ZodOptional<z.ZodString>;
+    table: z.ZodOptional<z.ZodString>;
+    schema: z.ZodOptional<z.ZodEnum<{
+        auto: "auto";
+        manual: "manual";
+    }>>;
+}, z.core.$strip>;
+declare const SettingsSchema: z.ZodObject<{
+    sqlite: z.ZodObject<{
+        url: z.ZodString;
+        authToken: z.ZodOptional<z.ZodString>;
+        table: z.ZodOptional<z.ZodString>;
+        schema: z.ZodOptional<z.ZodEnum<{
+            auto: "auto";
+            manual: "manual";
+        }>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+type Settings$1 = z.infer<typeof SettingsSchema>;
+
+declare const MappingSchema: z.ZodObject<{
+    table: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type Mapping = z.infer<typeof MappingSchema>;
+
+declare const settings: _walkeros_core_dev.JSONSchema;
+declare const mapping: _walkeros_core_dev.JSONSchema;
+
+type index$1_Mapping = Mapping;
+declare const index$1_MappingSchema: typeof MappingSchema;
+declare const index$1_SettingsSchema: typeof SettingsSchema;
+declare const index$1_SqliteSettingsSchema: typeof SqliteSettingsSchema;
+declare const index$1_mapping: typeof mapping;
+declare const index$1_settings: typeof settings;
+declare namespace index$1 {
+  export { type index$1_Mapping as Mapping, index$1_MappingSchema as MappingSchema, type Settings$1 as Settings, index$1_SettingsSchema as SettingsSchema, index$1_SqliteSettingsSchema as SqliteSettingsSchema, index$1_mapping as mapping, index$1_settings as settings };
+}
+
+type SchemaMode = 'auto' | 'manual';
+/**
+ * Thin cross-driver connection interface. Both drivers are adapted to this shape.
+ * Production code uses the adapters in src/drivers/*; tests inject a mock client
+ * via env.client to capture sql/args without touching a real database.
+ */
+interface SqliteClient {
+    /** Execute a SQL statement. Used for CREATE TABLE and ad-hoc commands. */
+    execute: (sql: string, args?: ReadonlyArray<unknown>) => Promise<void>;
+    /**
+     * Prepare a statement for repeated execution. Returned function binds args and runs.
+     */
+    prepare: (sql: string) => (args: ReadonlyArray<unknown>) => Promise<void>;
+    /** Close the connection. */
+    close: () => Promise<void>;
+}
+/**
+ * Factory that constructs an SqliteClient from the user's connection settings.
+ * Used by env.SqliteDriver so tests can inject a spy without mocking node_modules.
+ */
+type SqliteClientFactory = (url: string, authToken?: string) => Promise<SqliteClient>;
+interface SqliteSettings {
+    /**
+     * Connection URL. Starts with `libsql://`, `http://`, `https://`, `wss://`, `ws://`
+     * → libSQL driver. Anything else → better-sqlite3 (treated as a file path).
+     * Special value `:memory:` → in-memory (better-sqlite3).
+     */
+    url: string;
+    /** libSQL / Turso auth token. Ignored for better-sqlite3. */
+    authToken?: string;
+    /** Target table name. Defaults to `events`. */
+    table?: string;
+    /**
+     * `auto` runs `CREATE TABLE IF NOT EXISTS` with the canonical schema on init.
+     * `manual` skips CREATE TABLE. The user brings their own schema and mapping.
+     * Defaults to `auto`.
+     */
+    schema?: SchemaMode;
+    _client?: SqliteClient;
+    _runInsert?: (args: ReadonlyArray<unknown>) => Promise<void>;
+    _ownedClient?: boolean;
+}
+interface Settings {
+    sqlite: SqliteSettings;
+}
+/**
+ * Env -- optional driver override. Production leaves this undefined and the
+ * destination loads better-sqlite3 or @libsql/client dynamically. Tests
+ * provide a factory via `SqliteDriver` or a pre-built client via `client`.
+ */
+interface Env extends DestinationServer.Env {
+    SqliteDriver?: SqliteClientFactory;
+    client?: SqliteClient;
+}
+
+declare const push: Env;
+/**
+ * Simulation tracking paths. Specifies which function calls to record when
+ * running step examples through the collector.
+ */
+declare const simulation: string[];
+
+declare const env_push: typeof push;
+declare const env_simulation: typeof simulation;
+declare namespace env {
+  export { env_push as push, env_simulation as simulation };
+}
+
+/**
+ * Extended step example that may carry destination-level settings overrides.
+ */
+type SqliteStepExample = Flow.StepExample & {
+    settings?: Partial<Settings>;
+};
+/**
+ * Canonical insert into the default `events` table. `out` records the
+ * column args the prepared INSERT is bound with.
+ */
+declare const defaultInsert: SqliteStepExample;
+/**
+ * Custom table name. Verifies table overrides while using the canonical column set.
+ */
+declare const customTable: SqliteStepExample;
+/**
+ * Order event with numeric data. Confirms JSON serialization of nested values.
+ */
+declare const orderComplete: SqliteStepExample;
+/**
+ * Table override per rule -- routes this event to a dedicated table.
+ */
+declare const tableOverride: SqliteStepExample;
+/**
+ * Ignored event -- mapping.ignore: true produces no insert call.
+ */
+declare const ignoredEvent: SqliteStepExample;
+
+type step_SqliteStepExample = SqliteStepExample;
+declare const step_customTable: typeof customTable;
+declare const step_defaultInsert: typeof defaultInsert;
+declare const step_ignoredEvent: typeof ignoredEvent;
+declare const step_orderComplete: typeof orderComplete;
+declare const step_tableOverride: typeof tableOverride;
+declare namespace step {
+  export { type step_SqliteStepExample as SqliteStepExample, step_customTable as customTable, step_defaultInsert as defaultInsert, step_ignoredEvent as ignoredEvent, step_orderComplete as orderComplete, step_tableOverride as tableOverride };
+}
+
+declare const index_env: typeof env;
+declare const index_step: typeof step;
+declare namespace index {
+  export { index_env as env, index_step as step };
+}
+
+export { index as examples, index$1 as schemas };

package/dist/dev.d.ts

@@ -0,0 +1,158 @@
+import * as _walkeros_core_dev from '@walkeros/core/dev';
+import { z } from '@walkeros/core/dev';
+import { DestinationServer } from '@walkeros/server-core';
+import { Flow } from '@walkeros/core';
+
+declare const SqliteSettingsSchema: z.ZodObject<{
+    url: z.ZodString;
+    authToken: z.ZodOptional<z.ZodString>;
+    table: z.ZodOptional<z.ZodString>;
+    schema: z.ZodOptional<z.ZodEnum<{
+        auto: "auto";
+        manual: "manual";
+    }>>;
+}, z.core.$strip>;
+declare const SettingsSchema: z.ZodObject<{
+    sqlite: z.ZodObject<{
+        url: z.ZodString;
+        authToken: z.ZodOptional<z.ZodString>;
+        table: z.ZodOptional<z.ZodString>;
+        schema: z.ZodOptional<z.ZodEnum<{
+            auto: "auto";
+            manual: "manual";
+        }>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+type Settings$1 = z.infer<typeof SettingsSchema>;
+
+declare const MappingSchema: z.ZodObject<{
+    table: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type Mapping = z.infer<typeof MappingSchema>;
+
+declare const settings: _walkeros_core_dev.JSONSchema;
+declare const mapping: _walkeros_core_dev.JSONSchema;
+
+type index$1_Mapping = Mapping;
+declare const index$1_MappingSchema: typeof MappingSchema;
+declare const index$1_SettingsSchema: typeof SettingsSchema;
+declare const index$1_SqliteSettingsSchema: typeof SqliteSettingsSchema;
+declare const index$1_mapping: typeof mapping;
+declare const index$1_settings: typeof settings;
+declare namespace index$1 {
+  export { type index$1_Mapping as Mapping, index$1_MappingSchema as MappingSchema, type Settings$1 as Settings, index$1_SettingsSchema as SettingsSchema, index$1_SqliteSettingsSchema as SqliteSettingsSchema, index$1_mapping as mapping, index$1_settings as settings };
+}
+
+type SchemaMode = 'auto' | 'manual';
+/**
+ * Thin cross-driver connection interface. Both drivers are adapted to this shape.
+ * Production code uses the adapters in src/drivers/*; tests inject a mock client
+ * via env.client to capture sql/args without touching a real database.
+ */
+interface SqliteClient {
+    /** Execute a SQL statement. Used for CREATE TABLE and ad-hoc commands. */
+    execute: (sql: string, args?: ReadonlyArray<unknown>) => Promise<void>;
+    /**
+     * Prepare a statement for repeated execution. Returned function binds args and runs.
+     */
+    prepare: (sql: string) => (args: ReadonlyArray<unknown>) => Promise<void>;
+    /** Close the connection. */
+    close: () => Promise<void>;
+}
+/**
+ * Factory that constructs an SqliteClient from the user's connection settings.
+ * Used by env.SqliteDriver so tests can inject a spy without mocking node_modules.
+ */
+type SqliteClientFactory = (url: string, authToken?: string) => Promise<SqliteClient>;
+interface SqliteSettings {
+    /**
+     * Connection URL. Starts with `libsql://`, `http://`, `https://`, `wss://`, `ws://`
+     * → libSQL driver. Anything else → better-sqlite3 (treated as a file path).
+     * Special value `:memory:` → in-memory (better-sqlite3).
+     */
+    url: string;
+    /** libSQL / Turso auth token. Ignored for better-sqlite3. */
+    authToken?: string;
+    /** Target table name. Defaults to `events`. */
+    table?: string;
+    /**
+     * `auto` runs `CREATE TABLE IF NOT EXISTS` with the canonical schema on init.
+     * `manual` skips CREATE TABLE. The user brings their own schema and mapping.
+     * Defaults to `auto`.
+     */
+    schema?: SchemaMode;
+    _client?: SqliteClient;
+    _runInsert?: (args: ReadonlyArray<unknown>) => Promise<void>;
+    _ownedClient?: boolean;
+}
+interface Settings {
+    sqlite: SqliteSettings;
+}
+/**
+ * Env -- optional driver override. Production leaves this undefined and the
+ * destination loads better-sqlite3 or @libsql/client dynamically. Tests
+ * provide a factory via `SqliteDriver` or a pre-built client via `client`.
+ */
+interface Env extends DestinationServer.Env {
+    SqliteDriver?: SqliteClientFactory;
+    client?: SqliteClient;
+}
+
+declare const push: Env;
+/**
+ * Simulation tracking paths. Specifies which function calls to record when
+ * running step examples through the collector.
+ */
+declare const simulation: string[];
+
+declare const env_push: typeof push;
+declare const env_simulation: typeof simulation;
+declare namespace env {
+  export { env_push as push, env_simulation as simulation };
+}
+
+/**
+ * Extended step example that may carry destination-level settings overrides.
+ */
+type SqliteStepExample = Flow.StepExample & {
+    settings?: Partial<Settings>;
+};
+/**
+ * Canonical insert into the default `events` table. `out` records the
+ * column args the prepared INSERT is bound with.
+ */
+declare const defaultInsert: SqliteStepExample;
+/**
+ * Custom table name. Verifies table overrides while using the canonical column set.
+ */
+declare const customTable: SqliteStepExample;
+/**
+ * Order event with numeric data. Confirms JSON serialization of nested values.
+ */
+declare const orderComplete: SqliteStepExample;
+/**
+ * Table override per rule -- routes this event to a dedicated table.
+ */
+declare const tableOverride: SqliteStepExample;
+/**
+ * Ignored event -- mapping.ignore: true produces no insert call.
+ */
+declare const ignoredEvent: SqliteStepExample;
+
+type step_SqliteStepExample = SqliteStepExample;
+declare const step_customTable: typeof customTable;
+declare const step_defaultInsert: typeof defaultInsert;
+declare const step_ignoredEvent: typeof ignoredEvent;
+declare const step_orderComplete: typeof orderComplete;
+declare const step_tableOverride: typeof tableOverride;
+declare namespace step {
+  export { type step_SqliteStepExample as SqliteStepExample, step_customTable as customTable, step_defaultInsert as defaultInsert, step_ignoredEvent as ignoredEvent, step_orderComplete as orderComplete, step_tableOverride as tableOverride };
+}
+
+declare const index_env: typeof env;
+declare const index_step: typeof step;
+declare namespace index {
+  export { index_env as env, index_step as step };
+}
+
+export { index as examples, index$1 as schemas };

package/dist/dev.js

@@ -0,0 +1 @@
+"use strict";var e,t=Object.defineProperty,r=Object.getOwnPropertyDescriptor,s=Object.getOwnPropertyNames,i=Object.prototype.hasOwnProperty,o=(e,r)=>{for(var s in r)t(e,s,{get:r[s],enumerable:!0})},n={};o(n,{examples:()=>b,schemas:()=>a}),module.exports=(e=n,((e,o,n,a)=>{if(o&&"object"==typeof o||"function"==typeof o)for(let l of s(o))i.call(e,l)||l===n||t(e,l,{get:()=>o[l],enumerable:!(a=r(o,l))||a.enumerable});return e})(t({},"__esModule",{value:!0}),e));var a={};o(a,{MappingSchema:()=>d,SettingsSchema:()=>m,SqliteSettingsSchema:()=>p,mapping:()=>g,settings:()=>v});var l=require("@walkeros/core/dev"),c=require("@walkeros/core/dev"),p=c.z.object({url:c.z.string().min(1).describe("SQLite connection URL. libsql://, http(s)://, ws(s):// route to libSQL/Turso. Anything else is treated as a local file path via better-sqlite3. Use ':memory:' for an ephemeral in-memory database."),authToken:c.z.string().describe("libSQL / Turso auth token. Ignored for better-sqlite3 (local) connections.").optional(),table:c.z.string().describe('Target table name. Defaults to "events".').optional(),schema:c.z.enum(["auto","manual"]).describe('"auto" creates the canonical events table with CREATE TABLE IF NOT EXISTS on init. "manual" skips table creation. The user brings their own schema and mapping.').optional()}),m=c.z.object({sqlite:p.describe("SQLite / libSQL configuration (like { url: './events.db' } or { url: 'libsql://my-db.turso.io', authToken: '...' })")}),u=require("@walkeros/core/dev"),d=u.z.object({table:u.z.string().describe("Override target table name for this rule. Takes precedence over settings.sqlite.table.").optional()}),v=(0,l.zodToSchema)(m),g=(0,l.zodToSchema)(d),b={};o(b,{env:()=>y,step:()=>O});var y={};o(y,{push:()=>h,simulation:()=>S});var f={execute:()=>Promise.resolve(),prepare:()=>()=>Promise.resolve(),close:()=>Promise.resolve()},h={SqliteDriver:()=>Promise.resolve(f)},S=["call:client.prepare","call:client.execute"],O={};o(O,{customTable:()=>q,defaultInsert:()=>T,ignoredEvent:()=>E,orderComplete:()=>w,tableOverride:()=>J});var N=require("@walkeros/core"),T={in:(0,N.getEvent)("page view",{timestamp:1700000100,id:"evt-1",user:{session:"sess-1",id:"user-42"},data:{title:"Home"},source:{type:"server",id:"https://example.com/",previous_id:"https://example.com/prev"},globals:{env:"prod"},consent:{analytics:!0}}),out:[["client.runInsert",[1700000100,"evt-1","page view","page","view","sess-1","user-42","https://example.com/","Home","https://example.com/prev",JSON.stringify({title:"Home"}),JSON.stringify({env:"prod"}),JSON.stringify({analytics:!0})]]]},q={in:(0,N.getEvent)("form submit",{timestamp:1700000101,id:"evt-2",user:{session:"sess-99",id:""},data:{type:"contact"},source:{type:"server",id:"https://example.com/contact",previous_id:""},globals:{},consent:{}}),settings:{sqlite:{url:":memory:",table:"siteEvents"}},out:[["client.runInsert",[1700000101,"evt-2","form submit","form","submit","sess-99","","https://example.com/contact","","",JSON.stringify({type:"contact"}),JSON.stringify({}),JSON.stringify({})]]]},w={in:(0,N.getEvent)("order complete",{timestamp:1700000102,id:"evt-3",user:{session:"",id:""},data:{id:"ORD-1",total:99},source:{type:"server",id:"",previous_id:""},globals:{},consent:{}}),out:[["client.runInsert",[1700000102,"evt-3","order complete","order","complete","","","","","",JSON.stringify({id:"ORD-1",total:99}),JSON.stringify({}),JSON.stringify({})]]]},J={in:(0,N.getEvent)("order complete",{timestamp:1700000103,id:"evt-4",user:{session:"",id:""},data:{id:"ORD-2",total:42},source:{type:"server",id:"",previous_id:""},globals:{},consent:{}}),mapping:{settings:{table:"orders"}},out:[["client.runInsert",[1700000103,"evt-4","order complete","order","complete","","","","","",JSON.stringify({id:"ORD-2",total:42}),JSON.stringify({}),JSON.stringify({})]]]},E={in:(0,N.getEvent)("debug noise",{timestamp:1700000104,id:"evt-5",source:{type:"server",id:"",previous_id:""}}),mapping:{ignore:!0},out:[]};//# sourceMappingURL=dev.js.map

package/dist/dev.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/dev.ts","../src/schemas/index.ts","../src/schemas/settings.ts","../src/schemas/mapping.ts","../src/examples/index.ts","../src/examples/env.ts","../src/examples/step.ts"],"sourcesContent":["export * as schemas from './schemas';\nexport * as examples from './examples';\n","import { zodToSchema } from '@walkeros/core/dev';\nimport { SettingsSchema } from './settings';\nimport { MappingSchema } from './mapping';\n\nexport {\n  SettingsSchema,\n  SqliteSettingsSchema,\n  type Settings,\n} from './settings';\nexport { MappingSchema, type Mapping } from './mapping';\n\n// JSON Schema\nexport const settings = zodToSchema(SettingsSchema);\nexport const mapping = zodToSchema(MappingSchema);\n","import { z } from '@walkeros/core/dev';\n\nexport const SqliteSettingsSchema = z.object({\n  url: z\n    .string()\n    .min(1)\n    .describe(\n      \"SQLite connection URL. libsql://, http(s)://, ws(s):// route to libSQL/Turso. Anything else is treated as a local file path via better-sqlite3. Use ':memory:' for an ephemeral in-memory database.\",\n    ),\n  authToken: z\n    .string()\n    .describe(\n      'libSQL / Turso auth token. Ignored for better-sqlite3 (local) connections.',\n    )\n    .optional(),\n  table: z\n    .string()\n    .describe('Target table name. Defaults to \"events\".')\n    .optional(),\n  schema: z\n    .enum(['auto', 'manual'])\n    .describe(\n      '\"auto\" creates the canonical events table with CREATE TABLE IF NOT EXISTS on init. \"manual\" skips table creation. The user brings their own schema and mapping.',\n    )\n    .optional(),\n});\n\nexport const SettingsSchema = z.object({\n  sqlite: SqliteSettingsSchema.describe(\n    \"SQLite / libSQL configuration (like { url: './events.db' } or { url: 'libsql://my-db.turso.io', authToken: '...' })\",\n  ),\n});\n\nexport type Settings = z.infer<typeof SettingsSchema>;\n","import { z } from '@walkeros/core/dev';\n\nexport const MappingSchema = z.object({\n  table: z\n    .string()\n    .describe(\n      'Override target table name for this rule. Takes precedence over settings.sqlite.table.',\n    )\n    .optional(),\n});\n\nexport type Mapping = z.infer<typeof MappingSchema>;\n","export * as env from './env';\nexport * as step from './step';\n","import type { Env, SqliteClient, SqliteClientFactory } from '../types';\n\n// Narrow helper type aliases so mock functions are typed without `any`.\ntype ExecuteFn = (sql: string, args?: ReadonlyArray<unknown>) => Promise<void>;\ntype PrepareFn = (\n  sql: string,\n) => (args: ReadonlyArray<unknown>) => Promise<void>;\ntype CloseFn = () => Promise<void>;\n\nconst asyncExecute: ExecuteFn = () => Promise.resolve();\nconst asyncClose: CloseFn = () => Promise.resolve();\nconst asyncPrepare: PrepareFn = () => () => Promise.resolve();\n\nconst mockClient: SqliteClient = {\n  execute: asyncExecute,\n  prepare: asyncPrepare,\n  close: asyncClose,\n};\n\nconst mockFactory: SqliteClientFactory = () => Promise.resolve(mockClient);\n\nexport const push: Env = {\n  SqliteDriver: mockFactory,\n};\n\n/**\n * Simulation tracking paths. Specifies which function calls to record when\n * running step examples through the collector.\n */\nexport const simulation = ['call:client.prepare', 'call:client.execute'];\n","import type { Flow } from '@walkeros/core';\nimport { getEvent } from '@walkeros/core';\nimport type { Settings } from '../types';\n\n/**\n * Extended step example that may carry destination-level settings overrides.\n */\nexport type SqliteStepExample = Flow.StepExample & {\n  settings?: Partial<Settings>;\n};\n\n/**\n * Canonical insert into the default `events` table. `out` records the\n * column args the prepared INSERT is bound with.\n */\nexport const defaultInsert: SqliteStepExample = {\n  in: getEvent('page view', {\n    timestamp: 1700000100,\n    id: 'evt-1',\n    user: { session: 'sess-1', id: 'user-42' },\n    data: { title: 'Home' },\n    source: {\n      type: 'server',\n      id: 'https://example.com/',\n      previous_id: 'https://example.com/prev',\n    },\n    globals: { env: 'prod' },\n    consent: { analytics: true },\n  }),\n  out: [\n    [\n      'client.runInsert',\n      [\n        1700000100,\n        'evt-1',\n        'page view',\n        'page',\n        'view',\n        'sess-1',\n        'user-42',\n        'https://example.com/',\n        'Home',\n        'https://example.com/prev',\n        JSON.stringify({ title: 'Home' }),\n        JSON.stringify({ env: 'prod' }),\n        JSON.stringify({ analytics: true }),\n      ],\n    ],\n  ],\n};\n\n/**\n * Custom table name. Verifies table overrides while using the canonical column set.\n */\nexport const customTable: SqliteStepExample = {\n  in: getEvent('form submit', {\n    timestamp: 1700000101,\n    id: 'evt-2',\n    user: { session: 'sess-99', id: '' },\n    data: { type: 'contact' },\n    source: {\n      type: 'server',\n      id: 'https://example.com/contact',\n      previous_id: '',\n    },\n    globals: {},\n    consent: {},\n  }),\n  settings: {\n    sqlite: {\n      url: ':memory:',\n      table: 'siteEvents',\n    },\n  },\n  out: [\n    [\n      'client.runInsert',\n      [\n        1700000101,\n        'evt-2',\n        'form submit',\n        'form',\n        'submit',\n        'sess-99',\n        '',\n        'https://example.com/contact',\n        '',\n        '',\n        JSON.stringify({ type: 'contact' }),\n        JSON.stringify({}),\n        JSON.stringify({}),\n      ],\n    ],\n  ],\n};\n\n/**\n * Order event with numeric data. Confirms JSON serialization of nested values.\n */\nexport const orderComplete: SqliteStepExample = {\n  in: getEvent('order complete', {\n    timestamp: 1700000102,\n    id: 'evt-3',\n    user: { session: '', id: '' },\n    data: { id: 'ORD-1', total: 99 },\n    source: { type: 'server', id: '', previous_id: '' },\n    globals: {},\n    consent: {},\n  }),\n  out: [\n    [\n      'client.runInsert',\n      [\n        1700000102,\n        'evt-3',\n        'order complete',\n        'order',\n        'complete',\n        '',\n        '',\n        '',\n        '',\n        '',\n        JSON.stringify({ id: 'ORD-1', total: 99 }),\n        JSON.stringify({}),\n        JSON.stringify({}),\n      ],\n    ],\n  ],\n};\n\n/**\n * Table override per rule -- routes this event to a dedicated table.\n */\nexport const tableOverride: SqliteStepExample = {\n  in: getEvent('order complete', {\n    timestamp: 1700000103,\n    id: 'evt-4',\n    user: { session: '', id: '' },\n    data: { id: 'ORD-2', total: 42 },\n    source: { type: 'server', id: '', previous_id: '' },\n    globals: {},\n    consent: {},\n  }),\n  mapping: {\n    settings: {\n      table: 'orders',\n    },\n  },\n  out: [\n    [\n      'client.runInsert',\n      [\n        1700000103,\n        'evt-4',\n        'order complete',\n        'order',\n        'complete',\n        '',\n        '',\n        '',\n        '',\n        '',\n        JSON.stringify({ id: 'ORD-2', total: 42 }),\n        JSON.stringify({}),\n        JSON.stringify({}),\n      ],\n    ],\n  ],\n};\n\n/**\n * Ignored event -- mapping.ignore: true produces no insert call.\n */\nexport const ignoredEvent: SqliteStepExample = {\n  in: getEvent('debug noise', {\n    timestamp: 1700000104,\n    id: 'evt-5',\n    source: { type: 'server', id: '', previous_id: '' },\n  }),\n  mapping: { ignore: true },\n  out: [],\n};\n"],"mappings":"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","names":["import_dev","import_dev"]}

package/dist/dev.mjs

@@ -0,0 +1 @@
+var e=Object.defineProperty,t=(t,s)=>{for(var i in s)e(t,i,{get:s[i],enumerable:!0})},s={};t(s,{MappingSchema:()=>l,SettingsSchema:()=>a,SqliteSettingsSchema:()=>o,mapping:()=>c,settings:()=>m});import{zodToSchema as i}from"@walkeros/core/dev";import{z as r}from"@walkeros/core/dev";var o=r.object({url:r.string().min(1).describe("SQLite connection URL. libsql://, http(s)://, ws(s):// route to libSQL/Turso. Anything else is treated as a local file path via better-sqlite3. Use ':memory:' for an ephemeral in-memory database."),authToken:r.string().describe("libSQL / Turso auth token. Ignored for better-sqlite3 (local) connections.").optional(),table:r.string().describe('Target table name. Defaults to "events".').optional(),schema:r.enum(["auto","manual"]).describe('"auto" creates the canonical events table with CREATE TABLE IF NOT EXISTS on init. "manual" skips table creation. The user brings their own schema and mapping.').optional()}),a=r.object({sqlite:o.describe("SQLite / libSQL configuration (like { url: './events.db' } or { url: 'libsql://my-db.turso.io', authToken: '...' })")});import{z as n}from"@walkeros/core/dev";var l=n.object({table:n.string().describe("Override target table name for this rule. Takes precedence over settings.sqlite.table.").optional()}),m=i(a),c=i(l),p={};t(p,{env:()=>d,step:()=>b});var d={};t(d,{push:()=>v,simulation:()=>g});var u={execute:()=>Promise.resolve(),prepare:()=>()=>Promise.resolve(),close:()=>Promise.resolve()},v={SqliteDriver:()=>Promise.resolve(u)},g=["call:client.prepare","call:client.execute"],b={};t(b,{customTable:()=>S,defaultInsert:()=>y,ignoredEvent:()=>N,orderComplete:()=>h,tableOverride:()=>O});import{getEvent as f}from"@walkeros/core";var y={in:f("page view",{timestamp:1700000100,id:"evt-1",user:{session:"sess-1",id:"user-42"},data:{title:"Home"},source:{type:"server",id:"https://example.com/",previous_id:"https://example.com/prev"},globals:{env:"prod"},consent:{analytics:!0}}),out:[["client.runInsert",[1700000100,"evt-1","page view","page","view","sess-1","user-42","https://example.com/","Home","https://example.com/prev",JSON.stringify({title:"Home"}),JSON.stringify({env:"prod"}),JSON.stringify({analytics:!0})]]]},S={in:f("form submit",{timestamp:1700000101,id:"evt-2",user:{session:"sess-99",id:""},data:{type:"contact"},source:{type:"server",id:"https://example.com/contact",previous_id:""},globals:{},consent:{}}),settings:{sqlite:{url:":memory:",table:"siteEvents"}},out:[["client.runInsert",[1700000101,"evt-2","form submit","form","submit","sess-99","","https://example.com/contact","","",JSON.stringify({type:"contact"}),JSON.stringify({}),JSON.stringify({})]]]},h={in:f("order complete",{timestamp:1700000102,id:"evt-3",user:{session:"",id:""},data:{id:"ORD-1",total:99},source:{type:"server",id:"",previous_id:""},globals:{},consent:{}}),out:[["client.runInsert",[1700000102,"evt-3","order complete","order","complete","","","","","",JSON.stringify({id:"ORD-1",total:99}),JSON.stringify({}),JSON.stringify({})]]]},O={in:f("order complete",{timestamp:1700000103,id:"evt-4",user:{session:"",id:""},data:{id:"ORD-2",total:42},source:{type:"server",id:"",previous_id:""},globals:{},consent:{}}),mapping:{settings:{table:"orders"}},out:[["client.runInsert",[1700000103,"evt-4","order complete","order","complete","","","","","",JSON.stringify({id:"ORD-2",total:42}),JSON.stringify({}),JSON.stringify({})]]]},N={in:f("debug noise",{timestamp:1700000104,id:"evt-5",source:{type:"server",id:"",previous_id:""}}),mapping:{ignore:!0},out:[]};export{p as examples,s as schemas};//# sourceMappingURL=dev.mjs.map

package/dist/dev.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schemas/index.ts","../src/schemas/settings.ts","../src/schemas/mapping.ts","../src/examples/index.ts","../src/examples/env.ts","../src/examples/step.ts"],"sourcesContent":["import { zodToSchema } from '@walkeros/core/dev';\nimport { SettingsSchema } from './settings';\nimport { MappingSchema } from './mapping';\n\nexport {\n  SettingsSchema,\n  SqliteSettingsSchema,\n  type Settings,\n} from './settings';\nexport { MappingSchema, type Mapping } from './mapping';\n\n// JSON Schema\nexport const settings = zodToSchema(SettingsSchema);\nexport const mapping = zodToSchema(MappingSchema);\n","import { z } from '@walkeros/core/dev';\n\nexport const SqliteSettingsSchema = z.object({\n  url: z\n    .string()\n    .min(1)\n    .describe(\n      \"SQLite connection URL. libsql://, http(s)://, ws(s):// route to libSQL/Turso. Anything else is treated as a local file path via better-sqlite3. Use ':memory:' for an ephemeral in-memory database.\",\n    ),\n  authToken: z\n    .string()\n    .describe(\n      'libSQL / Turso auth token. Ignored for better-sqlite3 (local) connections.',\n    )\n    .optional(),\n  table: z\n    .string()\n    .describe('Target table name. Defaults to \"events\".')\n    .optional(),\n  schema: z\n    .enum(['auto', 'manual'])\n    .describe(\n      '\"auto\" creates the canonical events table with CREATE TABLE IF NOT EXISTS on init. \"manual\" skips table creation. The user brings their own schema and mapping.',\n    )\n    .optional(),\n});\n\nexport const SettingsSchema = z.object({\n  sqlite: SqliteSettingsSchema.describe(\n    \"SQLite / libSQL configuration (like { url: './events.db' } or { url: 'libsql://my-db.turso.io', authToken: '...' })\",\n  ),\n});\n\nexport type Settings = z.infer<typeof SettingsSchema>;\n","import { z } from '@walkeros/core/dev';\n\nexport const MappingSchema = z.object({\n  table: z\n    .string()\n    .describe(\n      'Override target table name for this rule. Takes precedence over settings.sqlite.table.',\n    )\n    .optional(),\n});\n\nexport type Mapping = z.infer<typeof MappingSchema>;\n","export * as env from './env';\nexport * as step from './step';\n","import type { Env, SqliteClient, SqliteClientFactory } from '../types';\n\n// Narrow helper type aliases so mock functions are typed without `any`.\ntype ExecuteFn = (sql: string, args?: ReadonlyArray<unknown>) => Promise<void>;\ntype PrepareFn = (\n  sql: string,\n) => (args: ReadonlyArray<unknown>) => Promise<void>;\ntype CloseFn = () => Promise<void>;\n\nconst asyncExecute: ExecuteFn = () => Promise.resolve();\nconst asyncClose: CloseFn = () => Promise.resolve();\nconst asyncPrepare: PrepareFn = () => () => Promise.resolve();\n\nconst mockClient: SqliteClient = {\n  execute: asyncExecute,\n  prepare: asyncPrepare,\n  close: asyncClose,\n};\n\nconst mockFactory: SqliteClientFactory = () => Promise.resolve(mockClient);\n\nexport const push: Env = {\n  SqliteDriver: mockFactory,\n};\n\n/**\n * Simulation tracking paths. Specifies which function calls to record when\n * running step examples through the collector.\n */\nexport const simulation = ['call:client.prepare', 'call:client.execute'];\n","import type { Flow } from '@walkeros/core';\nimport { getEvent } from '@walkeros/core';\nimport type { Settings } from '../types';\n\n/**\n * Extended step example that may carry destination-level settings overrides.\n */\nexport type SqliteStepExample = Flow.StepExample & {\n  settings?: Partial<Settings>;\n};\n\n/**\n * Canonical insert into the default `events` table. `out` records the\n * column args the prepared INSERT is bound with.\n */\nexport const defaultInsert: SqliteStepExample = {\n  in: getEvent('page view', {\n    timestamp: 1700000100,\n    id: 'evt-1',\n    user: { session: 'sess-1', id: 'user-42' },\n    data: { title: 'Home' },\n    source: {\n      type: 'server',\n      id: 'https://example.com/',\n      previous_id: 'https://example.com/prev',\n    },\n    globals: { env: 'prod' },\n    consent: { analytics: true },\n  }),\n  out: [\n    [\n      'client.runInsert',\n      [\n        1700000100,\n        'evt-1',\n        'page view',\n        'page',\n        'view',\n        'sess-1',\n        'user-42',\n        'https://example.com/',\n        'Home',\n        'https://example.com/prev',\n        JSON.stringify({ title: 'Home' }),\n        JSON.stringify({ env: 'prod' }),\n        JSON.stringify({ analytics: true }),\n      ],\n    ],\n  ],\n};\n\n/**\n * Custom table name. Verifies table overrides while using the canonical column set.\n */\nexport const customTable: SqliteStepExample = {\n  in: getEvent('form submit', {\n    timestamp: 1700000101,\n    id: 'evt-2',\n    user: { session: 'sess-99', id: '' },\n    data: { type: 'contact' },\n    source: {\n      type: 'server',\n      id: 'https://example.com/contact',\n      previous_id: '',\n    },\n    globals: {},\n    consent: {},\n  }),\n  settings: {\n    sqlite: {\n      url: ':memory:',\n      table: 'siteEvents',\n    },\n  },\n  out: [\n    [\n      'client.runInsert',\n      [\n        1700000101,\n        'evt-2',\n        'form submit',\n        'form',\n        'submit',\n        'sess-99',\n        '',\n        'https://example.com/contact',\n        '',\n        '',\n        JSON.stringify({ type: 'contact' }),\n        JSON.stringify({}),\n        JSON.stringify({}),\n      ],\n    ],\n  ],\n};\n\n/**\n * Order event with numeric data. Confirms JSON serialization of nested values.\n */\nexport const orderComplete: SqliteStepExample = {\n  in: getEvent('order complete', {\n    timestamp: 1700000102,\n    id: 'evt-3',\n    user: { session: '', id: '' },\n    data: { id: 'ORD-1', total: 99 },\n    source: { type: 'server', id: '', previous_id: '' },\n    globals: {},\n    consent: {},\n  }),\n  out: [\n    [\n      'client.runInsert',\n      [\n        1700000102,\n        'evt-3',\n        'order complete',\n        'order',\n        'complete',\n        '',\n        '',\n        '',\n        '',\n        '',\n        JSON.stringify({ id: 'ORD-1', total: 99 }),\n        JSON.stringify({}),\n        JSON.stringify({}),\n      ],\n    ],\n  ],\n};\n\n/**\n * Table override per rule -- routes this event to a dedicated table.\n */\nexport const tableOverride: SqliteStepExample = {\n  in: getEvent('order complete', {\n    timestamp: 1700000103,\n    id: 'evt-4',\n    user: { session: '', id: '' },\n    data: { id: 'ORD-2', total: 42 },\n    source: { type: 'server', id: '', previous_id: '' },\n    globals: {},\n    consent: {},\n  }),\n  mapping: {\n    settings: {\n      table: 'orders',\n    },\n  },\n  out: [\n    [\n      'client.runInsert',\n      [\n        1700000103,\n        'evt-4',\n        'order complete',\n        'order',\n        'complete',\n        '',\n        '',\n        '',\n        '',\n        '',\n        JSON.stringify({ id: 'ORD-2', total: 42 }),\n        JSON.stringify({}),\n        JSON.stringify({}),\n      ],\n    ],\n  ],\n};\n\n/**\n * Ignored event -- mapping.ignore: true produces no insert call.\n */\nexport const ignoredEvent: SqliteStepExample = {\n  in: getEvent('debug noise', {\n    timestamp: 1700000104,\n    id: 'evt-5',\n    source: { type: 'server', id: '', previous_id: '' },\n  }),\n  mapping: { ignore: true },\n  out: [],\n};\n"],"mappings":";;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,SAAS,mBAAmB;;;ACA5B,SAAS,SAAS;AAEX,IAAM,uBAAuB,EAAE,OAAO;AAAA,EAC3C,KAAK,EACF,OAAO,EACP,IAAI,CAAC,EACL;AAAA,IACC;AAAA,EACF;AAAA,EACF,WAAW,EACR,OAAO,EACP;AAAA,IACC;AAAA,EACF,EACC,SAAS;AAAA,EACZ,OAAO,EACJ,OAAO,EACP,SAAS,0CAA0C,EACnD,SAAS;AAAA,EACZ,QAAQ,EACL,KAAK,CAAC,QAAQ,QAAQ,CAAC,EACvB;AAAA,IACC;AAAA,EACF,EACC,SAAS;AACd,CAAC;AAEM,IAAM,iBAAiB,EAAE,OAAO;AAAA,EACrC,QAAQ,qBAAqB;AAAA,IAC3B;AAAA,EACF;AACF,CAAC;;;AC/BD,SAAS,KAAAA,UAAS;AAEX,IAAM,gBAAgBA,GAAE,OAAO;AAAA,EACpC,OAAOA,GACJ,OAAO,EACP;AAAA,IACC;AAAA,EACF,EACC,SAAS;AACd,CAAC;;;AFGM,IAAM,WAAW,YAAY,cAAc;AAC3C,IAAM,UAAU,YAAY,aAAa;;;AGbhD;AAAA;AAAA;AAAA;AAAA;;;ACAA;AAAA;AAAA;AAAA;AAAA;AASA,IAAM,eAA0B,MAAM,QAAQ,QAAQ;AACtD,IAAM,aAAsB,MAAM,QAAQ,QAAQ;AAClD,IAAM,eAA0B,MAAM,MAAM,QAAQ,QAAQ;AAE5D,IAAM,aAA2B;AAAA,EAC/B,SAAS;AAAA,EACT,SAAS;AAAA,EACT,OAAO;AACT;AAEA,IAAM,cAAmC,MAAM,QAAQ,QAAQ,UAAU;AAElE,IAAM,OAAY;AAAA,EACvB,cAAc;AAChB;AAMO,IAAM,aAAa,CAAC,uBAAuB,qBAAqB;;;AC7BvE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,SAAS,gBAAgB;AAclB,IAAM,gBAAmC;AAAA,EAC9C,IAAI,SAAS,aAAa;AAAA,IACxB,WAAW;AAAA,IACX,IAAI;AAAA,IACJ,MAAM,EAAE,SAAS,UAAU,IAAI,UAAU;AAAA,IACzC,MAAM,EAAE,OAAO,OAAO;AAAA,IACtB,QAAQ;AAAA,MACN,MAAM;AAAA,MACN,IAAI;AAAA,MACJ,aAAa;AAAA,IACf;AAAA,IACA,SAAS,EAAE,KAAK,OAAO;AAAA,IACvB,SAAS,EAAE,WAAW,KAAK;AAAA,EAC7B,CAAC;AAAA,EACD,KAAK;AAAA,IACH;AAAA,MACE;AAAA,MACA;AAAA,QACE;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA,KAAK,UAAU,EAAE,OAAO,OAAO,CAAC;AAAA,QAChC,KAAK,UAAU,EAAE,KAAK,OAAO,CAAC;AAAA,QAC9B,KAAK,UAAU,EAAE,WAAW,KAAK,CAAC;AAAA,MACpC;AAAA,IACF;AAAA,EACF;AACF;AAKO,IAAM,cAAiC;AAAA,EAC5C,IAAI,SAAS,eAAe;AAAA,IAC1B,WAAW;AAAA,IACX,IAAI;AAAA,IACJ,MAAM,EAAE,SAAS,WAAW,IAAI,GAAG;AAAA,IACnC,MAAM,EAAE,MAAM,UAAU;AAAA,IACxB,QAAQ;AAAA,MACN,MAAM;AAAA,MACN,IAAI;AAAA,MACJ,aAAa;AAAA,IACf;AAAA,IACA,SAAS,CAAC;AAAA,IACV,SAAS,CAAC;AAAA,EACZ,CAAC;AAAA,EACD,UAAU;AAAA,IACR,QAAQ;AAAA,MACN,KAAK;AAAA,MACL,OAAO;AAAA,IACT;AAAA,EACF;AAAA,EACA,KAAK;AAAA,IACH;AAAA,MACE;AAAA,MACA;AAAA,QACE;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAAA,QAClC,KAAK,UAAU,CAAC,CAAC;AAAA,QACjB,KAAK,UAAU,CAAC,CAAC;AAAA,MACnB;AAAA,IACF;AAAA,EACF;AACF;AAKO,IAAM,gBAAmC;AAAA,EAC9C,IAAI,SAAS,kBAAkB;AAAA,IAC7B,WAAW;AAAA,IACX,IAAI;AAAA,IACJ,MAAM,EAAE,SAAS,IAAI,IAAI,GAAG;AAAA,IAC5B,MAAM,EAAE,IAAI,SAAS,OAAO,GAAG;AAAA,IAC/B,QAAQ,EAAE,MAAM,UAAU,IAAI,IAAI,aAAa,GAAG;AAAA,IAClD,SAAS,CAAC;AAAA,IACV,SAAS,CAAC;AAAA,EACZ,CAAC;AAAA,EACD,KAAK;AAAA,IACH;AAAA,MACE;AAAA,MACA;AAAA,QACE;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA,KAAK,UAAU,EAAE,IAAI,SAAS,OAAO,GAAG,CAAC;AAAA,QACzC,KAAK,UAAU,CAAC,CAAC;AAAA,QACjB,KAAK,UAAU,CAAC,CAAC;AAAA,MACnB;AAAA,IACF;AAAA,EACF;AACF;AAKO,IAAM,gBAAmC;AAAA,EAC9C,IAAI,SAAS,kBAAkB;AAAA,IAC7B,WAAW;AAAA,IACX,IAAI;AAAA,IACJ,MAAM,EAAE,SAAS,IAAI,IAAI,GAAG;AAAA,IAC5B,MAAM,EAAE,IAAI,SAAS,OAAO,GAAG;AAAA,IAC/B,QAAQ,EAAE,MAAM,UAAU,IAAI,IAAI,aAAa,GAAG;AAAA,IAClD,SAAS,CAAC;AAAA,IACV,SAAS,CAAC;AAAA,EACZ,CAAC;AAAA,EACD,SAAS;AAAA,IACP,UAAU;AAAA,MACR,OAAO;AAAA,IACT;AAAA,EACF;AAAA,EACA,KAAK;AAAA,IACH;AAAA,MACE;AAAA,MACA;AAAA,QACE;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA,KAAK,UAAU,EAAE,IAAI,SAAS,OAAO,GAAG,CAAC;AAAA,QACzC,KAAK,UAAU,CAAC,CAAC;AAAA,QACjB,KAAK,UAAU,CAAC,CAAC;AAAA,MACnB;AAAA,IACF;AAAA,EACF;AACF;AAKO,IAAM,eAAkC;AAAA,EAC7C,IAAI,SAAS,eAAe;AAAA,IAC1B,WAAW;AAAA,IACX,IAAI;AAAA,IACJ,QAAQ,EAAE,MAAM,UAAU,IAAI,IAAI,aAAa,GAAG;AAAA,EACpD,CAAC;AAAA,EACD,SAAS,EAAE,QAAQ,KAAK;AAAA,EACxB,KAAK,CAAC;AACR;","names":["z"]}

package/dist/examples/index.d.mts

@@ -0,0 +1,110 @@
+import { DestinationServer } from '@walkeros/server-core';
+import { Flow } from '@walkeros/core';
+
+type SchemaMode = 'auto' | 'manual';
+/**
+ * Thin cross-driver connection interface. Both drivers are adapted to this shape.
+ * Production code uses the adapters in src/drivers/*; tests inject a mock client
+ * via env.client to capture sql/args without touching a real database.
+ */
+interface SqliteClient {
+    /** Execute a SQL statement. Used for CREATE TABLE and ad-hoc commands. */
+    execute: (sql: string, args?: ReadonlyArray<unknown>) => Promise<void>;
+    /**
+     * Prepare a statement for repeated execution. Returned function binds args and runs.
+     */
+    prepare: (sql: string) => (args: ReadonlyArray<unknown>) => Promise<void>;
+    /** Close the connection. */
+    close: () => Promise<void>;
+}
+/**
+ * Factory that constructs an SqliteClient from the user's connection settings.
+ * Used by env.SqliteDriver so tests can inject a spy without mocking node_modules.
+ */
+type SqliteClientFactory = (url: string, authToken?: string) => Promise<SqliteClient>;
+interface SqliteSettings {
+    /**
+     * Connection URL. Starts with `libsql://`, `http://`, `https://`, `wss://`, `ws://`
+     * → libSQL driver. Anything else → better-sqlite3 (treated as a file path).
+     * Special value `:memory:` → in-memory (better-sqlite3).
+     */
+    url: string;
+    /** libSQL / Turso auth token. Ignored for better-sqlite3. */
+    authToken?: string;
+    /** Target table name. Defaults to `events`. */
+    table?: string;
+    /**
+     * `auto` runs `CREATE TABLE IF NOT EXISTS` with the canonical schema on init.
+     * `manual` skips CREATE TABLE. The user brings their own schema and mapping.
+     * Defaults to `auto`.
+     */
+    schema?: SchemaMode;
+    _client?: SqliteClient;
+    _runInsert?: (args: ReadonlyArray<unknown>) => Promise<void>;
+    _ownedClient?: boolean;
+}
+interface Settings {
+    sqlite: SqliteSettings;
+}
+/**
+ * Env -- optional driver override. Production leaves this undefined and the
+ * destination loads better-sqlite3 or @libsql/client dynamically. Tests
+ * provide a factory via `SqliteDriver` or a pre-built client via `client`.
+ */
+interface Env extends DestinationServer.Env {
+    SqliteDriver?: SqliteClientFactory;
+    client?: SqliteClient;
+}
+
+declare const push: Env;
+/**
+ * Simulation tracking paths. Specifies which function calls to record when
+ * running step examples through the collector.
+ */
+declare const simulation: string[];
+
+declare const env_push: typeof push;
+declare const env_simulation: typeof simulation;
+declare namespace env {
+  export { env_push as push, env_simulation as simulation };
+}
+
+/**
+ * Extended step example that may carry destination-level settings overrides.
+ */
+type SqliteStepExample = Flow.StepExample & {
+    settings?: Partial<Settings>;
+};
+/**
+ * Canonical insert into the default `events` table. `out` records the
+ * column args the prepared INSERT is bound with.
+ */
+declare const defaultInsert: SqliteStepExample;
+/**
+ * Custom table name. Verifies table overrides while using the canonical column set.
+ */
+declare const customTable: SqliteStepExample;
+/**
+ * Order event with numeric data. Confirms JSON serialization of nested values.
+ */
+declare const orderComplete: SqliteStepExample;
+/**
+ * Table override per rule -- routes this event to a dedicated table.
+ */
+declare const tableOverride: SqliteStepExample;
+/**
+ * Ignored event -- mapping.ignore: true produces no insert call.
+ */
+declare const ignoredEvent: SqliteStepExample;
+
+type step_SqliteStepExample = SqliteStepExample;
+declare const step_customTable: typeof customTable;
+declare const step_defaultInsert: typeof defaultInsert;
+declare const step_ignoredEvent: typeof ignoredEvent;
+declare const step_orderComplete: typeof orderComplete;
+declare const step_tableOverride: typeof tableOverride;
+declare namespace step {
+  export { type step_SqliteStepExample as SqliteStepExample, step_customTable as customTable, step_defaultInsert as defaultInsert, step_ignoredEvent as ignoredEvent, step_orderComplete as orderComplete, step_tableOverride as tableOverride };
+}
+
+export { env, step };