orez-lite 0.10.2 → 0.10.3

package/README.md

@@ -5,8 +5,42 @@
 - `orez-lite` provides the host-neutral mutation executor.
 - `orez-lite/client` connects a stock Zero client to the HTTP sync protocol.
 - `orez-lite/browser` runs the engine with SQLite WASM in a browser worker.
+- `orez-lite/native` runs the prebuilt native engine from an application-owned
+  Zero schema, SQLite initializer, and HTTP policy callbacks.
 - `orez-lite/cloudflare` provides the Cloudflare runtime and data-worker factory.
 - `orez-lite/cloudflare/build` provides Node-side worker build and deployment tools.
 
 The package derives its database projection from the application’s Zero schema.
 Applications do not maintain separate table or column maps.
+
+## Native host
+
+The native host is configured entirely by the application:
+
+```ts
+import { createNativeHost } from 'orez-lite/native'
+
+const host = createNativeHost({
+  schema,
+  initSql,
+  dataDir: '.orez/native',
+  port: 7849,
+  adminTokenEnv: 'OREZ_ADMIN_TOKEN',
+  callbacks: {
+    authenticate: 'https://localhost:3000/api/zero/auth',
+    authorizeWake: 'https://localhost:3000/api/zero/wake-authorize',
+    transformQueries: 'https://localhost:3000/api/zero/pull',
+    certificateAuthority: '.certs/local-root.pem',
+  },
+  allowedOrigins: ['https://localhost:3000'],
+})
+
+const process = host.start({
+  env: { ...globalThis.process.env, OREZ_ADMIN_TOKEN: adminToken },
+})
+```
+
+Orez owns the sync protocol, namespace databases, query cache, and wake
+delivery. The callbacks keep authentication, authorization, and query policy in
+the application. Storage retention is disabled unless the application
+explicitly supplies `workerRetention`.

package/dist/browser/generated/sync_wasm.js

@@ -478,7 +478,7 @@ function __wbg_get_imports() {
             const ret = Object.entries(arg0);
             return ret;
         },
-        __wbg_exec_59eb0bc29e4f02ff: function() { return handleError(function (arg0, arg1, arg2, arg3) {
+        __wbg_exec_0b4e8f9e7a8c0e02: function() { return handleError(function (arg0, arg1, arg2, arg3) {
             arg0.exec(getStringFromWasm0(arg1, arg2), arg3);
         }, arguments); },
         __wbg_get_507a50627bffa49b: function(arg0, arg1) {
@@ -588,7 +588,7 @@ function __wbg_get_imports() {
         __wbg_prototypesetcall_4770620bbe4688a0: function(arg0, arg1, arg2) {
             Uint8Array.prototype.set.call(getArrayU8FromWasm0(arg0, arg1), arg2);
         },
-        __wbg_query_03b6ce598fa1096c: function() { return handleError(function (arg0, arg1, arg2, arg3) {
+        __wbg_query_61b60d4aa0a8eccc: function() { return handleError(function (arg0, arg1, arg2, arg3) {
             const ret = arg0.query(getStringFromWasm0(arg1, arg2), arg3);
             return ret;
         }, arguments); },

package/dist/native.d.ts

@@ -0,0 +1,29 @@
+import { type ChildProcess, type SpawnOptions } from 'node:child_process';
+export interface NativeHostCallbacks {
+    authenticate: string | URL;
+    authorizeWake: string | URL;
+    transformQueries: string | URL;
+    certificateAuthority?: string;
+}
+export interface NativeHostWorkerRetention {
+    idleMs: number;
+    sweepIntervalMs: number;
+}
+export interface NativeHostOptions {
+    schema: unknown;
+    initSql: readonly string[];
+    dataDir: string;
+    port: number;
+    adminTokenEnv: string;
+    callbacks: NativeHostCallbacks;
+    host?: string;
+    allowedOrigins?: readonly string[];
+    workerRetention?: NativeHostWorkerRetention;
+    changeLogRows?: number;
+    maxChangeRows?: number;
+}
+export interface NativeHost {
+    start(options?: SpawnOptions): ChildProcess;
+}
+export declare function createNativeHost(options: NativeHostOptions): NativeHost;
+//# sourceMappingURL=native.d.ts.map

package/dist/native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../src/native.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAMhF,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,GAAG,GAAG,CAAA;IAC1B,aAAa,EAAE,MAAM,GAAG,GAAG,CAAA;IAC3B,gBAAgB,EAAE,MAAM,GAAG,GAAG,CAAA;IAC9B,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAC9B;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAA;IACd,eAAe,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,CAAA;IACf,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE,mBAAmB,CAAA;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC,eAAe,CAAC,EAAE,yBAAyB,CAAA;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,YAAY,CAAA;CAC5C;AAID,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CA2BvE"}

package/dist/native.js

@@ -0,0 +1,105 @@
+import { spawn } from 'node:child_process';
+import { mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+const load = createRequire(import.meta.url);
+export function createNativeHost(options) {
+    validateOptions(options);
+    return {
+        start(spawnOptions = {}) {
+            const configDir = mkdtempSync(join(tmpdir(), 'orez-native-'));
+            const schemaPath = join(configDir, 'schema.json');
+            const initSqlPath = join(configDir, 'init-sql.json');
+            try {
+                writeJson(schemaPath, options.schema);
+                writeJson(initSqlPath, options.initSql);
+                const launcher = load.resolve('orez-sync-native/launcher');
+                const child = spawn(process.execPath, [launcher, ...nativeHostArguments(options, schemaPath, initSqlPath)], { stdio: 'inherit', ...spawnOptions });
+                const cleanup = () => rmSync(configDir, { force: true, recursive: true });
+                child.once('error', cleanup);
+                child.once('close', cleanup);
+                return child;
+            }
+            catch (error) {
+                rmSync(configDir, { force: true, recursive: true });
+                throw error;
+            }
+        },
+    };
+}
+function nativeHostArguments(options, schemaPath, initSqlPath) {
+    const args = [
+        'serve',
+        '--schema',
+        schemaPath,
+        '--init-sql',
+        initSqlPath,
+        '--data-dir',
+        options.dataDir,
+        '--port',
+        String(options.port),
+        '--admin-token-env',
+        options.adminTokenEnv,
+        '--auth-url',
+        String(options.callbacks.authenticate),
+        '--wake-authorize-url',
+        String(options.callbacks.authorizeWake),
+        '--query-transform-url',
+        String(options.callbacks.transformQueries),
+    ];
+    if (options.host)
+        args.push('--host', options.host);
+    if (options.callbacks.certificateAuthority) {
+        args.push('--callback-ca', options.callbacks.certificateAuthority);
+    }
+    for (const origin of options.allowedOrigins ?? []) {
+        args.push('--allow-origin', origin);
+    }
+    if (options.workerRetention) {
+        args.push('--retention', 'workers', '--worker-idle-ms', String(options.workerRetention.idleMs), '--worker-sweep-ms', String(options.workerRetention.sweepIntervalMs));
+    }
+    if (options.changeLogRows !== undefined) {
+        args.push('--retain-changes', String(options.changeLogRows));
+    }
+    if (options.maxChangeRows !== undefined) {
+        args.push('--max-change-rows', String(options.maxChangeRows));
+    }
+    return args;
+}
+function validateOptions(options) {
+    positiveInteger(options.port, 'port');
+    if (!options.adminTokenEnv)
+        throw new TypeError('adminTokenEnv must not be empty');
+    if (!options.dataDir)
+        throw new TypeError('dataDir must not be empty');
+    if (!Array.isArray(options.initSql))
+        throw new TypeError('initSql must be an array');
+    for (const statement of options.initSql) {
+        if (typeof statement !== 'string' || !statement.trim()) {
+            throw new TypeError('initSql statements must be non-empty strings');
+        }
+    }
+    if (options.workerRetention) {
+        positiveInteger(options.workerRetention.idleMs, 'workerRetention.idleMs');
+        positiveInteger(options.workerRetention.sweepIntervalMs, 'workerRetention.sweepIntervalMs');
+    }
+    if (options.changeLogRows !== undefined) {
+        positiveInteger(options.changeLogRows, 'changeLogRows');
+    }
+    if (options.maxChangeRows !== undefined) {
+        positiveInteger(options.maxChangeRows, 'maxChangeRows');
+    }
+}
+function positiveInteger(value, name) {
+    if (!Number.isSafeInteger(value) || value < 1) {
+        throw new TypeError(`${name} must be a positive integer`);
+    }
+}
+function writeJson(path, value) {
+    const json = JSON.stringify(value);
+    if (json === undefined)
+        throw new TypeError('native host configuration must be JSON');
+    writeFileSync(path, json, { encoding: 'utf8', mode: 0o600 });
+}
+//# sourceMappingURL=native.js.map

package/dist/native.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orez-lite",
-  "version": "0.10.2",
+  "version": "0.10.3",
   "description": "SQLite and Rust sync engine for Zero applications",
   "type": "module",
   "sideEffects": [
@@ -36,6 +36,10 @@
       "types": "./dist/browser/index.d.ts",
       "import": "./dist/browser/index.js"
     },
+    "./native": {
+      "types": "./dist/native.d.ts",
+      "import": "./dist/native.js"
+    },
     "./cloudflare": {
       "types": "./dist/cloudflare.d.ts",
       "import": "./dist/cloudflare.js"
@@ -81,10 +85,10 @@
     "@noble/ciphers": "1.3.0",
     "@noble/curves": "1.9.7",
     "@noble/hashes": "1.8.0",
-    "bedrock-sqlite": "0.10.2",
+    "bedrock-sqlite": "0.10.3",
     "esbuild": "^0.25.0",
-    "orez-sync-cf-host": "0.10.2",
-    "orez-sync-executor": "0.10.2"
+    "orez-sync-cf-host": "0.10.3",
+    "orez-sync-executor": "0.10.3"
   },
   "peerDependencies": {
     "@rocicorp/zero": ">=1.7.0",
@@ -95,6 +99,9 @@
       "optional": true
     }
   },
+  "optionalDependencies": {
+    "orez-sync-native": "0.1.1"
+  },
   "devDependencies": {
     "@rocicorp/zero": "1.7.0",
     "@types/node": "^22.0.0",