@cero-base/cero 0.5.2 → 0.7.0

package/types/index.d.ts

@@ -25,6 +25,10 @@
  * @returns {Promise<Handle>}
  */
 export function cero(dir: string, spec: any, opts?: CeroOpts): Promise<Handle>;
+export namespace cero {
+    export { internal as _internal };
+    export function use(...exts: any[]): number;
+}
 /**
  * Restore a cero instance from a mnemonic phrase. Closes the running
  * instance, wipes the on-disk `main/` tree and re-opens with `recovery: true`
@@ -94,9 +98,10 @@ export type CeroOpts = {
     recoveryTimeout?: number;
 };
 import { Handle } from './handle/index.js';
+import { internal } from './lib/internal.js';
 import { Ref } from './handle/index.js';
 import { Local } from './local/index.js';
 import { Identity } from '@cero-base/core/identity';
 export { Handle, Ref, Local };
-export { put, set, get, del, count, watch, call, open } from "./lib/operators.js";
+export { put, set, get, del, count, watch, call, open, before, after } from "./lib/operators.js";
 export { t, schema } from "./lib/spec.js";

package/types/lib/constants.d.ts

@@ -0,0 +1,14 @@
+export const NS: "cero";
+export const COUNTERS: "counters";
+export const TIMEOUT: 30000;
+export const FLUSH: 500;
+export namespace DB_TYPE {
+    let string: string;
+    let uint: string;
+    let int: string;
+    let bool: string;
+    let bytes: string;
+    let json: string;
+    let fixed32: string;
+    let fixed64: string;
+}

package/types/lib/internal.d.ts

@@ -0,0 +1,3 @@
+export namespace internal {
+    let extensions: any[];
+}

package/types/lib/operators.d.ts

@@ -1,10 +1,22 @@
 export function put(ref: Ref, row: Record<string, any>): Promise<SingleResult>;
-export function set(ref: Ref, row: Record<string, any>): Promise<SingleResult>;
+export function set(ref: Ref, row: Record<string, any>, opts?: {
+    upsert?: boolean;
+}): Promise<SingleResult>;
 export function del(ref: Ref, id?: string): Promise<void>;
 export function count(ref: Ref, q?: Record<string, any>): Promise<{
     data: number;
 }>;
 export function call(ref: Ref, d?: Record<string, any>): Promise<any>;
+export function before(ref: Ref, fn: (ctx: {
+    op: string;
+    name: string;
+    row: any;
+}) => any): () => void;
+export function after(ref: Ref, fn: (ctx: {
+    op: string;
+    name: string;
+    row: any;
+}) => void): () => void;
 export function get(ref: Ref, q?: string | Record<string, any>): Promise<SingleResult | ListResult | GetByIdResult>;
 export function watch(ref: Ref, q?: Record<string, any>): any;
 export function open(ref: Ref, arg?: string | {

package/src/CLAUDE.md

@@ -1,3 +0,0 @@
-<claude-mem-context>
-
-</claude-mem-context>

package/src/handle/CLAUDE.md

@@ -1,3 +0,0 @@
-<claude-mem-context>
-
-</claude-mem-context>

package/src/lib/CLAUDE.md

@@ -1,3 +0,0 @@
-<claude-mem-context>
-
-</claude-mem-context>

package/src/lib/builtins.js

@@ -1,413 +0,0 @@
-/**
- * Builtin type/collection/dispatch/rpc definitions used by the builder.
- * Every cero schema includes these; user-defined refs are added on top.
- *
- * @typedef {{ name: string, type: string, verb?: string, kind?: string }} BuiltinRef
- * @typedef {{ name: string, type: string, required: boolean }} FieldDesc
- * @typedef {{ name: string, compact: boolean, fields: FieldDesc[] }} TypeDesc
- * @typedef {{ name: string, schema: string, key: string[] }} CollectionDesc
- * @typedef {{ name: string, requestType: string }} DispatchDesc
- * @typedef {{
- *   name: string,
- *   request: { name: string },
- *   response: { name: string, stream?: boolean }
- * }} CommandDesc
- */
-
-/**
- * Refs that exist on every main (Handle) schema.
- *
- * @type {BuiltinRef[]}
- */
-export const BUILTINS = [
-  { name: 'members', type: 'member', verb: 'member' },
-  { name: 'devices', type: 'device', verb: 'device' },
-  { name: 'invites', type: 'invite', verb: 'invite' },
-  { name: 'handles', type: 'handle', verb: 'handle' }
-]
-
-/**
- * Refs that exist on every local schema.
- *
- * @type {BuiltinRef[]}
- */
-export const LOCAL_BUILTINS = [
-  { name: 'master', type: 'master', kind: 'single' },
-  { name: 'keypair', type: 'keypair', kind: 'single' },
-  { name: 'handle-keypairs', type: 'handle-keypair', kind: 'collection' }
-]
-
-const HYPERDB_TYPE = {
-  string: 'string',
-  uint: 'uint',
-  int: 'int',
-  bool: 'bool',
-  bytes: 'buffer',
-  json: 'json',
-  fixed32: 'fixed32',
-  fixed64: 'fixed64'
-}
-
-/**
- * Map a schema-DSL primitive name to its HyperDB type name.
- *
- * @param {string} prim
- * @returns {string}
- */
-export function hyperdbType(prim) {
-  return HYPERDB_TYPE[prim] || 'string'
-}
-
-/**
- * Type descriptors registered into every main schema.
- *
- * @returns {TypeDesc[]}
- */
-export function builtinTypes() {
-  return [
-    { name: 'del-by-id', compact: false, fields: [{ name: 'id', type: 'string', required: true }] },
-    {
-      name: 'writer',
-      compact: false,
-      fields: [
-        { name: 'master', type: 'buffer', required: true },
-        { name: 'writer', type: 'buffer', required: true },
-        { name: 'sig', type: 'buffer', required: true },
-        { name: 'name', type: 'string', required: false },
-        { name: 'isMobile', type: 'bool', required: false },
-        { name: 'isIndexer', type: 'bool', required: false }
-      ]
-    },
-    {
-      name: 'counter',
-      compact: false,
-      fields: [
-        { name: 'name', type: 'string', required: true },
-        { name: 'value', type: 'uint', required: true }
-      ]
-    },
-    {
-      name: 'member',
-      compact: false,
-      fields: [
-        { name: 'id', type: 'string', required: true },
-        { name: 'key', type: 'buffer', required: true },
-        { name: 'role', type: 'string', required: true },
-        { name: 'name', type: 'string', required: false },
-        { name: 'createdAt', type: 'int', required: false },
-        { name: 'updatedAt', type: 'int', required: false },
-        { name: 'sig', type: 'buffer', required: false },
-        { name: 'index', type: 'uint', required: false }
-      ]
-    },
-    {
-      name: 'device',
-      compact: false,
-      fields: [
-        { name: 'id', type: 'string', required: true },
-        { name: 'memberId', type: 'string', required: false },
-        { name: 'name', type: 'string', required: false },
-        { name: 'isMobile', type: 'bool', required: false },
-        { name: 'createdAt', type: 'int', required: false },
-        { name: 'updatedAt', type: 'int', required: false },
-        { name: 'index', type: 'uint', required: false }
-      ]
-    },
-    {
-      name: 'invite',
-      compact: false,
-      fields: [
-        { name: 'id', type: 'string', required: true },
-        { name: 'invite', type: 'buffer', required: true },
-        { name: 'publicKey', type: 'buffer', required: true },
-        { name: 'data', type: 'buffer', required: false },
-        { name: 'sig', type: 'buffer', required: false },
-        { name: 'role', type: 'string', required: true },
-        { name: 'expires', type: 'int', required: false },
-        { name: 'createdAt', type: 'int', required: false },
-        { name: 'index', type: 'uint', required: false }
-      ]
-    },
-    {
-      name: 'handle',
-      compact: false,
-      fields: [
-        { name: 'id', type: 'string', required: true },
-        { name: 'type', type: 'string', required: true },
-        { name: 'key', type: 'buffer', required: true },
-        { name: 'encryptionKey', type: 'buffer', required: false },
-        { name: 'name', type: 'string', required: false },
-        { name: 'createdAt', type: 'int', required: false },
-        { name: 'updatedAt', type: 'int', required: false },
-        { name: 'index', type: 'uint', required: false }
-      ]
-    },
-    {
-      name: 'claim',
-      compact: false,
-      fields: [
-        { name: 'identity', type: 'buffer', required: true },
-        { name: 'writer', type: 'buffer', required: true },
-        { name: 'sig', type: 'buffer', required: true },
-        { name: 'name', type: 'string', required: false },
-        { name: 'isMobile', type: 'bool', required: false }
-      ]
-    }
-  ]
-}
-
-/** Collection name for the internal counters table. */
-export const COUNTERS = 'counters'
-
-/**
- * Collection descriptors for every main schema, namespaced under `ns`.
- *
- * @param {string} ns
- * @returns {CollectionDesc[]}
- */
-export function builtinCollections(ns) {
-  const out = BUILTINS.map((b) => ({ name: b.name, schema: `@${ns}/${b.type}`, key: ['id'] }))
-  out.push({ name: COUNTERS, schema: `@${ns}/counter`, key: ['name'] })
-  return out
-}
-
-/**
- * Dispatch (mutation) descriptors for every main schema, namespaced under `ns`.
- *
- * @param {string} ns
- * @returns {DispatchDesc[]}
- */
-export function builtinDispatches(ns) {
-  const at = (n) => `@${ns}/${n}`
-  const out = [
-    { name: 'add-writer', requestType: at('writer') },
-    { name: 'del-writer', requestType: at('writer') },
-    { name: 'claim-writer', requestType: at('claim') }
-  ]
-  for (const b of BUILTINS) {
-    out.push({ name: `add-${b.verb}`, requestType: at(b.type) })
-    out.push({ name: `set-${b.verb}`, requestType: at(b.type) })
-    out.push({ name: `del-${b.verb}`, requestType: at('del-by-id') })
-  }
-  return out
-}
-
-/**
- * Type descriptors registered into every local schema.
- *
- * @returns {TypeDesc[]}
- */
-export function localBuiltinTypes() {
-  return [
-    { name: 'master', compact: false, fields: [{ name: 'seed', type: 'buffer', required: true }] },
-    {
-      name: 'keypair',
-      compact: false,
-      fields: [
-        { name: 'publicKey', type: 'buffer', required: true },
-        { name: 'secretKey', type: 'buffer', required: true }
-      ]
-    },
-    {
-      name: 'handle-keypair',
-      compact: false,
-      fields: [
-        { name: 'id', type: 'string', required: true },
-        { name: 'publicKey', type: 'buffer', required: true },
-        { name: 'secretKey', type: 'buffer', required: true },
-        { name: 'encryptionKey', type: 'buffer', required: false }
-      ]
-    }
-  ]
-}
-
-/**
- * Collection descriptors for every local schema, namespaced under `ns`.
- *
- * @param {string} ns
- * @returns {CollectionDesc[]}
- */
-export function localBuiltinCollections(ns) {
-  return [
-    { name: 'master', schema: `@${ns}/master`, key: [] },
-    { name: 'keypair', schema: `@${ns}/keypair`, key: [] },
-    { name: 'handle-keypairs', schema: `@${ns}/handle-keypair`, key: ['id'] }
-  ]
-}
-
-/**
- * Request/response type descriptors for the RPC facade.
- *
- * @returns {TypeDesc[]}
- */
-export function rpcTypes() {
-  return [
-    { name: 'req-empty', compact: false, fields: [{ name: 'ok', type: 'bool', required: false }] },
-    {
-      name: 'req-restore',
-      compact: false,
-      fields: [{ name: 'phrase', type: 'string', required: true }]
-    },
-    {
-      name: 'req-row',
-      compact: false,
-      fields: [
-        { name: 'handle', type: 'string', required: true },
-        { name: 'ref', type: 'string', required: true },
-        { name: 'data', type: 'buffer', required: true },
-        { name: 'local', type: 'bool', required: false }
-      ]
-    },
-    {
-      name: 'req-id',
-      compact: false,
-      fields: [
-        { name: 'handle', type: 'string', required: true },
-        { name: 'ref', type: 'string', required: true },
-        { name: 'id', type: 'string', required: true },
-        { name: 'local', type: 'bool', required: false }
-      ]
-    },
-    {
-      name: 'req-query',
-      compact: false,
-      fields: [
-        { name: 'handle', type: 'string', required: true },
-        { name: 'ref', type: 'string', required: true },
-        { name: 'query', type: 'buffer', required: false },
-        { name: 'local', type: 'bool', required: false }
-      ]
-    },
-    {
-      name: 'req-call',
-      compact: false,
-      fields: [
-        { name: 'handle', type: 'string', required: true },
-        { name: 'op', type: 'string', required: true },
-        { name: 'data', type: 'buffer', required: false }
-      ]
-    },
-    {
-      name: 'req-invite',
-      compact: false,
-      fields: [
-        { name: 'handle', type: 'string', required: true },
-        { name: 'role', type: 'string', required: false }
-      ]
-    },
-    {
-      name: 'req-revoke',
-      compact: false,
-      fields: [
-        { name: 'handle', type: 'string', required: true },
-        { name: 'invite', type: 'string', required: true }
-      ]
-    },
-    {
-      name: 'req-join',
-      compact: false,
-      fields: [
-        { name: 'parent', type: 'string', required: true },
-        { name: 'ref', type: 'string', required: true },
-        { name: 'invite', type: 'string', required: true }
-      ]
-    },
-    {
-      name: 'req-open',
-      compact: false,
-      fields: [
-        { name: 'parent', type: 'string', required: true },
-        { name: 'row', type: 'string', required: true }
-      ]
-    },
-    {
-      name: 'req-handle',
-      compact: false,
-      fields: [{ name: 'handle', type: 'string', required: true }]
-    },
-    {
-      name: 'res-data',
-      compact: false,
-      fields: [{ name: 'data', type: 'buffer', required: false }]
-    },
-    {
-      name: 'res-rows',
-      compact: false,
-      fields: [
-        { name: 'data', type: 'buffer', required: true },
-        { name: 'total', type: 'int', required: true },
-        { name: 'size', type: 'int', required: true }
-      ]
-    },
-    { name: 'res-count', compact: false, fields: [{ name: 'count', type: 'int', required: true }] },
-    {
-      name: 'res-invite',
-      compact: false,
-      fields: [{ name: 'invite', type: 'string', required: true }]
-    },
-    {
-      name: 'res-handle',
-      compact: false,
-      fields: [
-        { name: 'id', type: 'string', required: true },
-        { name: 'type', type: 'string', required: true },
-        { name: 'name', type: 'string', required: false }
-      ]
-    },
-    {
-      name: 'res-identity',
-      compact: false,
-      fields: [
-        { name: 'id', type: 'string', required: true },
-        { name: 'deviceId', type: 'string', required: false },
-        { name: 'phrase', type: 'string', required: false }
-      ]
-    },
-    { name: 'res-ok', compact: false, fields: [{ name: 'ok', type: 'bool', required: false }] }
-  ]
-}
-
-/**
- * RPC command (verb) descriptors for the cero server, namespaced under `ns`.
- *
- * @param {string} ns
- * @returns {CommandDesc[]}
- */
-export function rpcCommands(ns) {
-  const at = (n) => `@${ns}/${n}`
-  return [
-    {
-      name: 'init',
-      request: { name: at('req-empty') },
-      response: { name: at('res-identity') }
-    },
-    {
-      name: 'restore',
-      request: { name: at('req-restore') },
-      response: { name: at('res-identity') }
-    },
-    { name: 'add-row', request: { name: at('req-row') }, response: { name: at('res-data') } },
-    { name: 'add-handle', request: { name: at('req-row') }, response: { name: at('res-handle') } },
-    { name: 'set', request: { name: at('req-row') }, response: { name: at('res-data') } },
-    { name: 'get', request: { name: at('req-query') }, response: { name: at('res-rows') } },
-    { name: 'get-one', request: { name: at('req-id') }, response: { name: at('res-data') } },
-    { name: 'del', request: { name: at('req-id') }, response: { name: at('res-ok') } },
-    { name: 'count', request: { name: at('req-query') }, response: { name: at('res-count') } },
-    {
-      name: 'watch',
-      request: { name: at('req-query') },
-      response: { name: at('res-rows'), stream: true }
-    },
-    { name: 'call', request: { name: at('req-call') }, response: { name: at('res-data') } },
-    { name: 'invite', request: { name: at('req-invite') }, response: { name: at('res-invite') } },
-    { name: 'revoke', request: { name: at('req-revoke') }, response: { name: at('res-ok') } },
-    { name: 'join', request: { name: at('req-join') }, response: { name: at('res-handle') } },
-    {
-      name: 'open-handle',
-      request: { name: at('req-open') },
-      response: { name: at('res-handle') }
-    },
-    { name: 'close-handle', request: { name: at('req-handle') }, response: { name: at('res-ok') } },
-    { name: 'leave', request: { name: at('req-handle') }, response: { name: at('res-ok') } }
-  ]
-}

package/types/lib/builtins.d.ts

@@ -1,141 +0,0 @@
-/**
- * Map a schema-DSL primitive name to its HyperDB type name.
- *
- * @param {string} prim
- * @returns {string}
- */
-export function hyperdbType(prim: string): string;
-/**
- * Type descriptors registered into every main schema.
- *
- * @returns {TypeDesc[]}
- */
-export function builtinTypes(): TypeDesc[];
-/**
- * Collection descriptors for every main schema, namespaced under `ns`.
- *
- * @param {string} ns
- * @returns {CollectionDesc[]}
- */
-export function builtinCollections(ns: string): CollectionDesc[];
-/**
- * Dispatch (mutation) descriptors for every main schema, namespaced under `ns`.
- *
- * @param {string} ns
- * @returns {DispatchDesc[]}
- */
-export function builtinDispatches(ns: string): DispatchDesc[];
-/**
- * Type descriptors registered into every local schema.
- *
- * @returns {TypeDesc[]}
- */
-export function localBuiltinTypes(): TypeDesc[];
-/**
- * Collection descriptors for every local schema, namespaced under `ns`.
- *
- * @param {string} ns
- * @returns {CollectionDesc[]}
- */
-export function localBuiltinCollections(ns: string): CollectionDesc[];
-/**
- * Request/response type descriptors for the RPC facade.
- *
- * @returns {TypeDesc[]}
- */
-export function rpcTypes(): TypeDesc[];
-/**
- * RPC command (verb) descriptors for the cero server, namespaced under `ns`.
- *
- * @param {string} ns
- * @returns {CommandDesc[]}
- */
-export function rpcCommands(ns: string): CommandDesc[];
-/**
- * Builtin type/collection/dispatch/rpc definitions used by the builder.
- * Every cero schema includes these; user-defined refs are added on top.
- *
- * @typedef {{ name: string, type: string, verb?: string, kind?: string }} BuiltinRef
- * @typedef {{ name: string, type: string, required: boolean }} FieldDesc
- * @typedef {{ name: string, compact: boolean, fields: FieldDesc[] }} TypeDesc
- * @typedef {{ name: string, schema: string, key: string[] }} CollectionDesc
- * @typedef {{ name: string, requestType: string }} DispatchDesc
- * @typedef {{
- *   name: string,
- *   request: { name: string },
- *   response: { name: string, stream?: boolean }
- * }} CommandDesc
- */
-/**
- * Refs that exist on every main (Handle) schema.
- *
- * @type {BuiltinRef[]}
- */
-export const BUILTINS: BuiltinRef[];
-/**
- * Refs that exist on every local schema.
- *
- * @type {BuiltinRef[]}
- */
-export const LOCAL_BUILTINS: BuiltinRef[];
-/** Collection name for the internal counters table. */
-export const COUNTERS: "counters";
-/**
- * Builtin type/collection/dispatch/rpc definitions used by the builder.
- * Every cero schema includes these; user-defined refs are added on top.
- */
-export type BuiltinRef = {
-    name: string;
-    type: string;
-    verb?: string;
-    kind?: string;
-};
-/**
- * Builtin type/collection/dispatch/rpc definitions used by the builder.
- * Every cero schema includes these; user-defined refs are added on top.
- */
-export type FieldDesc = {
-    name: string;
-    type: string;
-    required: boolean;
-};
-/**
- * Builtin type/collection/dispatch/rpc definitions used by the builder.
- * Every cero schema includes these; user-defined refs are added on top.
- */
-export type TypeDesc = {
-    name: string;
-    compact: boolean;
-    fields: FieldDesc[];
-};
-/**
- * Builtin type/collection/dispatch/rpc definitions used by the builder.
- * Every cero schema includes these; user-defined refs are added on top.
- */
-export type CollectionDesc = {
-    name: string;
-    schema: string;
-    key: string[];
-};
-/**
- * Builtin type/collection/dispatch/rpc definitions used by the builder.
- * Every cero schema includes these; user-defined refs are added on top.
- */
-export type DispatchDesc = {
-    name: string;
-    requestType: string;
-};
-/**
- * Builtin type/collection/dispatch/rpc definitions used by the builder.
- * Every cero schema includes these; user-defined refs are added on top.
- */
-export type CommandDesc = {
-    name: string;
-    request: {
-        name: string;
-    };
-    response: {
-        name: string;
-        stream?: boolean;
-    };
-};