@weave-kit/engine 0.5.0 → 0.7.0

package/dist/core/storage/system-tables.js

@@ -0,0 +1,268 @@
+/**
+ * Engine-owned **system tables**.
+ *
+ * These are the engine's own bookkeeping tables (metadata cache, sequence
+ * counters, audit trail, approval queue, workflow timers, quota counters) plus
+ * the migration meta table. They are created **only by `weave migrate`** — the
+ * runtime never emits DDL, so the runtime database account can be
+ * least-privileged (no `CREATE`). `migrate` diffs them like any other table
+ * (idempotent, additive-only on existing tables).
+ *
+ * All tables live in the connection's `current_schema()`, alongside customer
+ * tables; they are never declared in a project's `objects/` tree.
+ */
+/** canonical names of the engine system tables (single source for docs/tests) */
+export const SYSTEM_TABLES = {
+    META: 'weavekit_meta',
+    METADATA: 'weavekit_metadata',
+    SEQ: 'weavekit_seq',
+    AUDIT: 'weavekit_audit',
+    APPROVALS: 'weavekit_approvals',
+    WORKFLOW_DEFINITIONS: 'weavekit_workflow_definitions',
+    WORKFLOW_INSTANCES: 'weavekit_workflow_instances',
+    WORKFLOW_STEPS: 'weavekit_workflow_steps',
+    WORKFLOW_WORKITEMS: 'weavekit_workflow_workitems',
+    WORKFLOW_LOCKS: 'weavekit_workflow_locks',
+    WORKFLOW_TIMERS: 'weavekit_workflow_timers',
+    COUNTERS: 'weavekit_counters',
+};
+/** all system table names, in a stable order */
+export const SYSTEM_TABLE_NAMES = Object.values(SYSTEM_TABLES);
+function col(name, type, opts = {}) {
+    return {
+        name,
+        type,
+        notNull: opts.notNull ?? false,
+        default: opts.default,
+        primary: opts.primary ?? false,
+        unique: opts.unique ?? false,
+    };
+}
+const meta = () => ({
+    name: SYSTEM_TABLES.META,
+    columns: [col('key', 'TEXT', { notNull: true, primary: true }), col('value', 'TEXT', { notNull: true })],
+    fks: [],
+    indexes: [],
+    uniques: [],
+});
+const metadata = () => ({
+    name: SYSTEM_TABLES.METADATA,
+    columns: [
+        col('object_name', 'TEXT', { notNull: true, primary: true }),
+        col('content_hash', 'TEXT', { notNull: true }),
+        col('definition', 'JSONB', { notNull: true }),
+        col('applied_at', 'TIMESTAMPTZ', { notNull: true, default: 'now()' }),
+        col('updated_at', 'TIMESTAMPTZ', { notNull: true, default: 'now()' }),
+    ],
+    fks: [],
+    indexes: [],
+    uniques: [],
+});
+const seq = () => ({
+    name: SYSTEM_TABLES.SEQ,
+    columns: [
+        col('object_name', 'TEXT', { notNull: true, primary: true }),
+        col('bucket', 'TEXT', { notNull: true, primary: true }),
+        col('last_value', 'BIGINT', { notNull: true }),
+    ],
+    fks: [],
+    indexes: [],
+    uniques: [],
+});
+const audit = () => ({
+    name: SYSTEM_TABLES.AUDIT,
+    columns: [
+        col('id', 'BIGSERIAL', { notNull: true, primary: true }),
+        col('ts', 'TIMESTAMPTZ', { notNull: true, default: 'now()' }),
+        col('actor_type', 'TEXT', { notNull: true }),
+        col('actor_id', 'TEXT', { notNull: true }),
+        col('action', 'TEXT', { notNull: true }),
+        col('object', 'TEXT'),
+        col('object_id', 'TEXT'),
+        col('changes', 'JSONB'),
+        col('before', 'JSONB'),
+        col('after', 'JSONB'),
+        col('is_error', 'BOOLEAN', { notNull: true, default: 'false' }),
+        col('error_code', 'TEXT'),
+        col('meta', 'JSONB'),
+    ],
+    fks: [],
+    indexes: [
+        { name: 'weavekit_audit_ts_idx', method: 'btree', columns: ['ts'] },
+        { name: 'weavekit_audit_actor_idx', method: 'btree', columns: ['actor_id'] },
+        { name: 'weavekit_audit_obj_idx', method: 'btree', columns: ['object', 'object_id'] },
+    ],
+    uniques: [],
+});
+const approvals = () => ({
+    name: SYSTEM_TABLES.APPROVALS,
+    columns: [
+        col('approval_key', 'TEXT', { notNull: true, primary: true }),
+        col('action', 'TEXT', { notNull: true }),
+        col('args', 'JSONB', { notNull: true }),
+        col('actor_key', 'TEXT', { notNull: true }),
+        col('status', 'TEXT', { notNull: true }),
+        col('created_at', 'TIMESTAMPTZ', { notNull: true, default: 'now()' }),
+        col('approved_by', 'TEXT'),
+        col('resolved_at', 'TIMESTAMPTZ'),
+    ],
+    fks: [],
+    indexes: [
+        { name: 'weavekit_approvals_status_created_idx', method: 'btree', columns: ['status', 'created_at'] },
+        { name: 'weavekit_approvals_actor_idx', method: 'btree', columns: ['actor_key'] },
+    ],
+    uniques: [],
+});
+const workflowDefinitions = () => ({
+    name: SYSTEM_TABLES.WORKFLOW_DEFINITIONS,
+    columns: [
+        col('object', 'TEXT', { notNull: true, primary: true }),
+        col('hash', 'TEXT', { notNull: true, primary: true }),
+        col('version_seq', 'INTEGER', { notNull: true }),
+        col('definition', 'JSONB', { notNull: true }),
+        col('created_at', 'TIMESTAMPTZ', { notNull: true, default: 'now()' }),
+    ],
+    fks: [],
+    indexes: [],
+    uniques: [{ name: 'weavekit_workflow_definitions_object_seq_key', columns: ['object', 'version_seq'] }],
+});
+const workflowInstances = () => ({
+    name: SYSTEM_TABLES.WORKFLOW_INSTANCES,
+    columns: [
+        col('object', 'TEXT', { notNull: true, primary: true }),
+        col('record_key', 'TEXT', { notNull: true, primary: true }),
+        col('workflow_hash', 'TEXT', { notNull: true }),
+        col('state', 'TEXT', { notNull: true }),
+        col('current_step_id', 'UUID'),
+        col('originator', 'TEXT', { notNull: true }),
+        col('originator_parent', 'TEXT'),
+        col('approval', 'TEXT'),
+        col('created_at', 'TIMESTAMPTZ', { notNull: true, default: 'now()' }),
+        col('started_at', 'TIMESTAMPTZ'),
+        col('activated_at', 'TIMESTAMPTZ'),
+        col('finished_at', 'TIMESTAMPTZ'),
+    ],
+    fks: [],
+    indexes: [],
+    uniques: [],
+});
+const workflowSteps = () => ({
+    name: SYSTEM_TABLES.WORKFLOW_STEPS,
+    columns: [
+        col('id', 'UUID', { notNull: true, primary: true }),
+        col('object', 'TEXT', { notNull: true }),
+        col('record_key', 'TEXT', { notNull: true }),
+        col('node_id', 'TEXT', { notNull: true }),
+        col('kind', 'TEXT', { notNull: true }),
+        col('ordinal', 'INTEGER', { notNull: true }),
+        col('state', 'TEXT', { notNull: true }),
+        col('approval', 'TEXT'),
+        col('prev_step_id', 'UUID'),
+        col('entered_at', 'TIMESTAMPTZ', { notNull: true, default: 'now()' }),
+        col('finished_at', 'TIMESTAMPTZ'),
+    ],
+    fks: [],
+    indexes: [
+        { name: 'weavekit_workflow_steps_record_idx', method: 'btree', columns: ['object', 'record_key', 'ordinal'] },
+    ],
+    uniques: [],
+});
+const workflowWorkitems = () => ({
+    name: SYSTEM_TABLES.WORKFLOW_WORKITEMS,
+    columns: [
+        col('id', 'UUID', { notNull: true, primary: true }),
+        col('object', 'TEXT', { notNull: true }),
+        col('record_key', 'TEXT', { notNull: true }),
+        col('step_id', 'UUID', { notNull: true }),
+        col('node_id', 'TEXT', { notNull: true }),
+        col('kind', 'TEXT', { notNull: true }),
+        col('participant', 'TEXT', { notNull: true }),
+        col('state', 'TEXT', { notNull: true }),
+        col('approval', 'TEXT'),
+        col('action', 'TEXT'),
+        col('finisher', 'TEXT'),
+        col('delegant', 'TEXT'),
+        col('receiptor', 'TEXT'),
+        col('comment', 'TEXT'),
+        col('received_at', 'TIMESTAMPTZ', { notNull: true, default: 'now()' }),
+        col('started_at', 'TIMESTAMPTZ'),
+        col('finished_at', 'TIMESTAMPTZ'),
+        col('allowed_at', 'TIMESTAMPTZ'),
+    ],
+    fks: [],
+    indexes: [
+        { name: 'weavekit_workflow_workitems_todo_idx', method: 'btree', columns: ['participant', 'state', 'kind'] },
+        { name: 'weavekit_workflow_workitems_step_idx', method: 'btree', columns: ['step_id', 'state'] },
+        { name: 'weavekit_workflow_workitems_record_idx', method: 'btree', columns: ['object', 'record_key'] },
+    ],
+    uniques: [],
+});
+const workflowLocks = () => ({
+    name: SYSTEM_TABLES.WORKFLOW_LOCKS,
+    columns: [
+        col('workitem_id', 'UUID', { notNull: true, primary: true }),
+        col('object', 'TEXT', { notNull: true }),
+        col('record_key', 'TEXT', { notNull: true }),
+        col('holder', 'TEXT', { notNull: true }),
+        col('acquired_at', 'TIMESTAMPTZ', { notNull: true, default: 'now()' }),
+        col('expires_at', 'TIMESTAMPTZ', { notNull: true }),
+    ],
+    fks: [],
+    indexes: [{ name: 'weavekit_workflow_locks_expiry_idx', method: 'btree', columns: ['expires_at'] }],
+    uniques: [],
+});
+const workflowTimers = () => ({
+    name: SYSTEM_TABLES.WORKFLOW_TIMERS,
+    columns: [
+        col('object', 'TEXT', { notNull: true, primary: true }),
+        col('record_key', 'TEXT', { notNull: true, primary: true }),
+        col('node_id', 'TEXT', { notNull: true }),
+        col('due_at', 'TIMESTAMPTZ', { notNull: true }),
+        col('workflow_hash', 'TEXT'),
+    ],
+    fks: [],
+    indexes: [{ name: 'weavekit_workflow_timers_due_idx', method: 'btree', columns: ['due_at'] }],
+    uniques: [],
+});
+const counters = () => ({
+    name: SYSTEM_TABLES.COUNTERS,
+    columns: [
+        col('key', 'TEXT', { notNull: true, primary: true }),
+        col('period_start', 'TIMESTAMPTZ', { notNull: true, primary: true }),
+        col('value', 'BIGINT', { notNull: true, default: '0' }),
+        col('updated_at', 'TIMESTAMPTZ', { notNull: true, default: 'now()' }),
+    ],
+    fks: [],
+    indexes: [],
+    uniques: [],
+});
+/**
+ * The expected shape of every engine system table. `migrate` diffs this list
+ * unconditionally, so a single `weave migrate` provisions everything the
+ * runtime needs; the runtime itself never runs DDL.
+ */
+export function buildSystemTables() {
+    return [
+        meta(),
+        metadata(),
+        seq(),
+        audit(),
+        approvals(),
+        workflowDefinitions(),
+        workflowInstances(),
+        workflowSteps(),
+        workflowWorkitems(),
+        workflowLocks(),
+        workflowTimers(),
+        counters(),
+    ];
+}
+/**
+ * ACL hardening for system tables (run by `migrate`, idempotent). The audit
+ * trail is append-only: non-owners must not be able to erase history.
+ * (`DROP` is ownership-only in PostgreSQL; `TRUNCATE` is the grantable risk.)
+ */
+export function systemHardeningStatements() {
+    return [`REVOKE TRUNCATE ON ${SYSTEM_TABLES.AUDIT} FROM PUBLIC;`];
+}
+//# sourceMappingURL=system-tables.js.map

package/dist/core/storage/system-tables.js.map

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

package/dist/core/tools/policies.d.ts

@@ -1,7 +1,7 @@
 import type { GuardrailContext, GuardrailDecision, GuardrailPolicy } from './types.js';
 /**
- * Guardrail policy evaluation core — pure, zero-dependency, protocol-agnostic
- * (D13: tool calls today, workflow activities later both run this). Policies
+ * Guardrail policy evaluation core — pure, zero-dependency, protocol-agnostic,
+ * shared by every tool caller. Policies
  * run in declaration order; the first `deny`/`requireApproval` short-circuits;
  * `mask` decisions merge (later wins). Fail-closed: a policy that throws denies
  * the call (`mcp.policy.denied`). No policies configured = fast-path allow.

package/dist/core/tools/policies.js

@@ -1,6 +1,6 @@
 /**
- * Guardrail policy evaluation core — pure, zero-dependency, protocol-agnostic
- * (D13: tool calls today, workflow activities later both run this). Policies
+ * Guardrail policy evaluation core — pure, zero-dependency, protocol-agnostic,
+ * shared by every tool caller. Policies
  * run in declaration order; the first `deny`/`requireApproval` short-circuits;
  * `mask` decisions merge (later wins). Fail-closed: a policy that throws denies
  * the call (`mcp.policy.denied`). No policies configured = fast-path allow.

package/dist/core/tools/types.d.ts

@@ -1,9 +1,9 @@
-import type { RbacSubject } from '../rbac/index.js';
+import type { IdentitySubject } from '../rbac/index.js';
 import type { Locale } from '../i18n/index.js';
 import type { AuditSink } from '../audit/index.js';
 import type { ApprovalStatus } from './values.js';
 /**
- * Tool-surface contracts (M10 open contract). Zero-dependency, no runtime
+ * Tool-surface contracts (open contract). Zero-dependency, no runtime
  * imports — `runtime` depends on `core`, so `core` must not reference runtime
  * types (dependency DAG). The runtime `ObjectDataAccess` structurally
  * satisfies `ToolDataAccess` (method bivariance), so no adapter is needed at
@@ -37,7 +37,7 @@ export interface ToolFindResult<T = Record<string, unknown>> {
     total: number;
 }
 export interface ToolDataAccessContext {
-    subject?: RbacSubject;
+    subject?: IdentitySubject;
     locale?: Locale;
 }
 export interface ToolDataAccess {
@@ -96,7 +96,7 @@ export interface ApprovalListFilter {
  * Pluggable approval store (persistence backend). Implementations: in-memory
  * (`core/tools`, tests/default) and PG (`subsystems/approvals`, MIT — the
  * engine's mandated DB). A Redis backend is not implemented. The store
- * never audits — resolution audit (A7) belongs to the queue facade.
+ * never audits — resolution audit belongs to the queue facade.
  */
 export interface ApprovalsBackend {
     list(filter?: ApprovalListFilter): Promise<PendingApproval[]>;
@@ -131,7 +131,7 @@ export interface ToolResult {
 /** everything a custom tool handler may use — no raw pool/SQL/network */
 export interface ToolCallContext {
     dataAccess: ToolDataAccess;
-    subject: RbacSubject;
+    subject: IdentitySubject;
     actor: ToolActor;
     /** caller-supplied arguments of this invocation */
     args: Record<string, unknown>;
@@ -168,7 +168,7 @@ export type GuardrailDecision = {
 /** guardrail policy decision context (protocol-agnostic; `action` = tool name or workflow transition) */
 export interface GuardrailContext {
     actor: ToolActor;
-    subject: RbacSubject;
+    subject: IdentitySubject;
     action: string;
     args: Record<string, unknown>;
     /** amount-threshold style policies read business data through the same narrow surface */

package/dist/core/tools/types.d.ts.map

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

package/dist/core/tools/values.d.ts

@@ -22,6 +22,11 @@ export declare const INTROSPECTION_TOOLS: {
     readonly LIST_OBJECTS: "list_objects";
     readonly DESCRIBE_OBJECT: "describe_object";
 };
+/** fixed workflow tool names (exposed to subjects that can update a workflow object) */
+export declare const WORKFLOW_TOOLS: {
+    readonly TRANSITION: "workflow_transition";
+};
+export type WorkflowTool = typeof WORKFLOW_TOOLS[keyof typeof WORKFLOW_TOOLS];
 /** custom tool `name` format (snake_case, lowercase start) */
 export declare const TOOL_NAME_PATTERN = "^[a-z][a-z0-9_]*$";
 /** audit namespace prefix custom tools must not use (action = `<prefix>.<detail>`) */

package/dist/core/tools/values.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"values.d.ts","sourceRoot":"","sources":["../../../src/core/tools/values.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;;;CAMjB,CAAC;AACX,MAAM,MAAM,YAAY,GAAG,OAAO,cAAc,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;AAE9E,yCAAyC;AACzC,eAAO,MAAM,mBAAmB;;;CAGtB,CAAC;AAEX,8DAA8D;AAC9D,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AAErD,sFAAsF;AACtF,eAAO,MAAM,uBAAuB,SAAS,CAAC;AAE9C,oFAAoF;AACpF,eAAO,MAAM,iBAAiB;;;;CAIpB,CAAC;AACX,MAAM,MAAM,cAAc,GAAG,OAAO,iBAAiB,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC;AAItF,wFAAwF;AACxF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD"}
+{"version":3,"file":"values.d.ts","sourceRoot":"","sources":["../../../src/core/tools/values.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;;;CAMjB,CAAC;AACX,MAAM,MAAM,YAAY,GAAG,OAAO,cAAc,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;AAE9E,yCAAyC;AACzC,eAAO,MAAM,mBAAmB;;;CAGtB,CAAC;AAEX,wFAAwF;AACxF,eAAO,MAAM,cAAc;;CAEjB,CAAC;AACX,MAAM,MAAM,YAAY,GAAG,OAAO,cAAc,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;AAE9E,8DAA8D;AAC9D,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AAErD,sFAAsF;AACtF,eAAO,MAAM,uBAAuB,SAAS,CAAC;AAE9C,oFAAoF;AACpF,eAAO,MAAM,iBAAiB;;;;CAIpB,CAAC;AACX,MAAM,MAAM,cAAc,GAAG,OAAO,iBAAiB,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC;AAQtF,wFAAwF;AACxF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD"}

package/dist/core/tools/values.js

@@ -21,6 +21,10 @@ export const INTROSPECTION_TOOLS = {
     LIST_OBJECTS: 'list_objects',
     DESCRIBE_OBJECT: 'describe_object',
 };
+/** fixed workflow tool names (exposed to subjects that can update a workflow object) */
+export const WORKFLOW_TOOLS = {
+    TRANSITION: 'workflow_transition',
+};
 /** custom tool `name` format (snake_case, lowercase start) */
 export const TOOL_NAME_PATTERN = '^[a-z][a-z0-9_]*$';
 /** audit namespace prefix custom tools must not use (action = `<prefix>.<detail>`) */
@@ -31,7 +35,11 @@ export const APPROVAL_STATUSES = {
     APPROVED: 'approved',
     REJECTED: 'rejected',
 };
-const reservedNames = [...Object.values(REGISTRY_TOOLS), ...Object.values(INTROSPECTION_TOOLS)];
+const reservedNames = [
+    ...Object.values(REGISTRY_TOOLS),
+    ...Object.values(INTROSPECTION_TOOLS),
+    ...Object.values(WORKFLOW_TOOLS),
+];
 /** true when a custom tool name collides with a built-in tool or the audit namespace */
 export function isReservedToolName(name) {
     return reservedNames.includes(name) || name.startsWith(RESERVED_TOOL_NAMESPACE);

package/dist/core/tools/values.js.map

@@ -1 +1 @@
-{"version":3,"file":"values.js","sourceRoot":"","sources":["../../../src/core/tools/values.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,MAAM,EAAE,gBAAgB;IACxB,GAAG,EAAE,YAAY;IACjB,MAAM,EAAE,eAAe;IACvB,MAAM,EAAE,eAAe;IACvB,MAAM,EAAE,eAAe;CACf,CAAC;AAGX,yCAAyC;AACzC,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,YAAY,EAAE,cAAc;IAC5B,eAAe,EAAE,iBAAiB;CAC1B,CAAC;AAEX,8DAA8D;AAC9D,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAAmB,CAAC;AAErD,sFAAsF;AACtF,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC;AAE9C,oFAAoF;AACpF,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;CACZ,CAAC;AAGX,MAAM,aAAa,GAAsB,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,CAAC;AAEnH,wFAAwF;AACxF,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,OAAO,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,uBAAuB,CAAC,CAAC;AAClF,CAAC"}
+{"version":3,"file":"values.js","sourceRoot":"","sources":["../../../src/core/tools/values.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,MAAM,EAAE,gBAAgB;IACxB,GAAG,EAAE,YAAY;IACjB,MAAM,EAAE,eAAe;IACvB,MAAM,EAAE,eAAe;IACvB,MAAM,EAAE,eAAe;CACf,CAAC;AAGX,yCAAyC;AACzC,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,YAAY,EAAE,cAAc;IAC5B,eAAe,EAAE,iBAAiB;CAC1B,CAAC;AAEX,wFAAwF;AACxF,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,UAAU,EAAE,qBAAqB;CACzB,CAAC;AAGX,8DAA8D;AAC9D,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAAmB,CAAC;AAErD,sFAAsF;AACtF,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC;AAE9C,oFAAoF;AACpF,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;CACZ,CAAC;AAGX,MAAM,aAAa,GAAsB;IACvC,GAAG,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC;IAChC,GAAG,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC;IACrC,GAAG,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC;CACjC,CAAC;AAEF,wFAAwF;AACxF,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,OAAO,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,uBAAuB,CAAC,CAAC;AAClF,CAAC"}

package/dist/core/types/currency.d.ts

@@ -0,0 +1,9 @@
+/**
+ * ISO 4217 currency helpers for the `currency` field type. Browser-safe: uses
+ * only the global `Intl` (no imports), so it can be consumed from any layer.
+ */
+/** true when `code` is a currency the runtime recognizes (ISO 4217) */
+export declare function isCurrencyCode(code: string): boolean;
+/** minor-unit fraction digits for a currency (USD=2, JPY=0); falls back to 2 */
+export declare function currencyMinorUnits(code: string): number;
+//# sourceMappingURL=currency.d.ts.map

package/dist/core/types/currency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"currency.d.ts","sourceRoot":"","sources":["../../../src/core/types/currency.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,uEAAuE;AACvE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQpD;AAED,gFAAgF;AAChF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQvD"}

package/dist/core/types/currency.js

@@ -0,0 +1,28 @@
+/**
+ * ISO 4217 currency helpers for the `currency` field type. Browser-safe: uses
+ * only the global `Intl` (no imports), so it can be consumed from any layer.
+ */
+/** true when `code` is a currency the runtime recognizes (ISO 4217) */
+export function isCurrencyCode(code) {
+    if (!/^[A-Z]{3}$/.test(code))
+        return false;
+    try {
+        new Intl.NumberFormat('en', { style: 'currency', currency: code });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** minor-unit fraction digits for a currency (USD=2, JPY=0); falls back to 2 */
+export function currencyMinorUnits(code) {
+    try {
+        const digits = new Intl.NumberFormat('en', { style: 'currency', currency: code }).resolvedOptions()
+            .maximumFractionDigits;
+        return typeof digits === 'number' ? digits : 2;
+    }
+    catch {
+        return 2;
+    }
+}
+//# sourceMappingURL=currency.js.map

package/dist/core/types/currency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"currency.js","sourceRoot":"","sources":["../../../src/core/types/currency.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,uEAAuE;AACvE,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3C,IAAI,CAAC;QACH,IAAI,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACnE,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,eAAe,EAAE;aAChG,qBAAqB,CAAC;QACzB,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC"}

package/dist/core/types/field-type.d.ts

@@ -69,8 +69,11 @@ export interface FieldTypeRegistration {
     namespace?: string;
     /** the primitive this type inherits from; `undefined` = engine primitive/structural */
     base?: FieldType;
-    /** scalar (can be a primary key). Defaults from `base`. */
+    /** a scalar value type (usable as a value; see `keyEligible` for PK use). Defaults from `base`. */
     scalar?: boolean;
+    /** eligible as a primary key. Defaults from `base` (a scalar-only override for
+     *  value scalars PG cannot key on, e.g. json/jsonb/real/double/interval). */
+    keyEligible?: boolean;
     /** relation-like (carries `target`). Defaults from `base`. */
     relationLike?: boolean;
     /** frontend hints (consumed by `@weave-kit/ui`) */

package/dist/core/types/field-type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"field-type.d.ts","sourceRoot":"","sources":["../../../src/core/types/field-type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;;;;;;;;;;;;;;GAeG;AAEH,yFAAyF;AACzF,eAAO,MAAM,uBAAuB,kCAAkC,CAAC;AAEvE,8EAA8E;AAC9E,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wEAAwE;AACxE,eAAO,MAAM,UAAU;;;;;;;CAOb,CAAC;AACX,MAAM,MAAM,QAAQ,GAAG,OAAO,UAAU,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAElE,mEAAmE;AACnE,MAAM,WAAW,QAAQ;IACvB,sCAAsC;IACtC,IAAI,EAAE,QAAQ,CAAC;IACf,iCAAiC;IACjC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,iEAAiE;IACjE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,MAAM,CAAC;CAC5C;AAED;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAC;AAEhG,6DAA6D;AAC7D,MAAM,WAAW,qBAAqB;IACpC,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uFAAuF;IACvF,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,mDAAmD;IACnD,EAAE,CAAC,EAAE,gBAAgB,CAAC;IACtB,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2FAA2F;IAC3F,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACjC,uEAAuE;IACvE,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B;;;;;OAKG;IACH,OAAO,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAClE;AAED,+CAA+C;AAC/C,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC"}
+{"version":3,"file":"field-type.d.ts","sourceRoot":"","sources":["../../../src/core/types/field-type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;;;;;;;;;;;;;;GAeG;AAEH,yFAAyF;AACzF,eAAO,MAAM,uBAAuB,kCAAkC,CAAC;AAEvE,8EAA8E;AAC9E,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wEAAwE;AACxE,eAAO,MAAM,UAAU;;;;;;;CAOb,CAAC;AACX,MAAM,MAAM,QAAQ,GAAG,OAAO,UAAU,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAElE,mEAAmE;AACnE,MAAM,WAAW,QAAQ;IACvB,sCAAsC;IACtC,IAAI,EAAE,QAAQ,CAAC;IACf,iCAAiC;IACjC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,iEAAiE;IACjE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,MAAM,CAAC;CAC5C;AAED;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAC;AAEhG,6DAA6D;AAC7D,MAAM,WAAW,qBAAqB;IACpC,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uFAAuF;IACvF,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,mGAAmG;IACnG,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;iFAC6E;IAC7E,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,mDAAmD;IACnD,EAAE,CAAC,EAAE,gBAAgB,CAAC;IACtB,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2FAA2F;IAC3F,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACjC,uEAAuE;IACvE,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B;;;;;OAKG;IACH,OAAO,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAClE;AAED,+CAA+C;AAC/C,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC"}