@weave-kit/engine 0.4.0 → 0.6.0

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

@@ -1 +1 @@
-{"version":3,"file":"primaryField.d.ts","sourceRoot":"","sources":["../../../src/core/types/primaryField.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD;;;;;;;GAOG;AAEH,sEAAsE;AACtE,wBAAgB,cAAc,CAAC,GAAG,EAAE,gBAAgB,GAAG,SAAS,GAAG,eAAe,GAAG,SAAS,CAE7F;AAED,sFAAsF;AACtF,wBAAgB,YAAY,CAAC,GAAG,EAAE,gBAAgB,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAElF"}
+{"version":3,"file":"primaryField.d.ts","sourceRoot":"","sources":["../../../src/core/types/primaryField.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD;;;;;;;GAOG;AAEH,sEAAsE;AACtE,wBAAgB,cAAc,CAAC,GAAG,EAAE,gBAAgB,GAAG,SAAS,GAAG,eAAe,GAAG,SAAS,CAE7F;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,gBAAgB,GAAG,SAAS,GAAG,eAAe,EAAE,CAEpF;AAED,8FAA8F;AAC9F,wBAAgB,YAAY,CAAC,GAAG,EAAE,gBAAgB,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAElF"}

package/dist/core/types/primaryField.js

@@ -10,7 +10,14 @@
 export function primaryFieldOf(def) {
     return def === undefined ? undefined : def.fields.find((f) => f.primary === true);
 }
-/** name of the primary field; undefined when the object has no primary declaration */
+/**
+ * every primary field, in declaration order. A composite key carries more than
+ * one; declare order is the tuple order used by `record_key`.
+ */
+export function primaryFieldsOf(def) {
+    return def === undefined ? [] : def.fields.filter((f) => f.primary === true);
+}
+/** name of the (first) primary field; undefined when the object has no primary declaration */
 export function primaryKeyOf(def) {
     return primaryFieldOf(def)?.name;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"primaryField.js","sourceRoot":"","sources":["../../../src/core/types/primaryField.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AAEH,sEAAsE;AACtE,MAAM,UAAU,cAAc,CAAC,GAAiC;IAC9D,OAAO,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC;AACpF,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,YAAY,CAAC,GAAiC;IAC5D,OAAO,cAAc,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC;AACnC,CAAC"}
+{"version":3,"file":"primaryField.js","sourceRoot":"","sources":["../../../src/core/types/primaryField.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AAEH,sEAAsE;AACtE,MAAM,UAAU,cAAc,CAAC,GAAiC;IAC9D,OAAO,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC;AACpF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,GAAiC;IAC/D,OAAO,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC;AAC/E,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,YAAY,CAAC,GAAiC;IAC5D,OAAO,cAAc,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC;AACnC,CAAC"}

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

@@ -12,16 +12,18 @@ export declare function buildFieldTypeRegistry(extra?: readonly FieldTypeRegistr
 export declare function fieldBase(registry: FieldTypeRegistry, type: FieldType): FieldType;
 /** true for a relation-like field (target-by-FK) */
 export declare function isRelationLike(registry: FieldTypeRegistry, type: FieldType): boolean;
-/** true for a field type that can be a primary key */
+/** true for a scalar value type (see `isKeyEligible` for primary-key use) */
 export declare function isScalarFieldType(registry: FieldTypeRegistry, type: FieldType): boolean;
+/** true for a field type eligible as a primary key (scalar + key-eligible) */
+export declare function isKeyEligible(registry: FieldTypeRegistry, type: FieldType): boolean;
 /** the frontend visual hint for a type (single source) */
 export declare function fieldUiVisual(registry: FieldTypeRegistry, type: FieldType): string;
 /** the OpenAPI `format` hint for a type, if any */
 export declare function fieldOpenApiFormat(registry: FieldTypeRegistry, type: FieldType): string | undefined;
 /** a descriptor (or undefined for an unknown type) */
 export declare function describeFieldType(registry: FieldTypeRegistry, type: FieldType): FieldTypeRegistration | undefined;
-/** engine primitives — always allowed by the default whitelist. */
+/** always-enabled types — every scaffold preset (including `agent`) starts from these. */
 export declare const PRIMITIVE_FIELD_TYPES: readonly FieldType[];
-/** semantic types that are gated by the config `features.fieldTypes` whitelist. */
-export declare const SEMANTIC_FIELD_TYPES: readonly FieldType[];
+/** opt-in types — the non-`agent` presets add these; `features.fieldTypes` gates them. */
+export declare const OPT_IN_FIELD_TYPES: readonly FieldType[];
 //# sourceMappingURL=registry.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/core/types/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,KAAK,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AA6ChF,iFAAiF;AACjF,eAAO,MAAM,2BAA2B,EAAE,iBAA4B,CAAC;AAEvE;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,GAAE,SAAS,qBAAqB,EAAO,GAAG,iBAAiB,CAKtG;AAED,gFAAgF;AAChF,wBAAgB,SAAS,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,SAAS,GAAG,SAAS,CAEjF;AAED,oDAAoD;AACpD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAIpF;AAED,sDAAsD;AACtD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAIvF;AAED,0DAA0D;AAC1D,wBAAgB,aAAa,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,CAElF;AAED,mDAAmD;AACnD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAEnG;AAED,sDAAsD;AACtD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,SAAS,GAAG,qBAAqB,GAAG,SAAS,CAEjH;AAED,mEAAmE;AACnE,eAAO,MAAM,qBAAqB,EAAE,SAAS,SAAS,EAerD,CAAC;AAEF,mFAAmF;AACnF,eAAO,MAAM,oBAAoB,EAAE,SAAS,SAAS,EAQpD,CAAC"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/core/types/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,KAAK,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAqDhF,iFAAiF;AACjF,eAAO,MAAM,2BAA2B,EAAE,iBAA4B,CAAC;AAEvE;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,GAAE,SAAS,qBAAqB,EAAO,GAAG,iBAAiB,CAKtG;AAED,gFAAgF;AAChF,wBAAgB,SAAS,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,SAAS,GAAG,SAAS,CAEjF;AAED,oDAAoD;AACpD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAIpF;AAED,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAIvF;AAED,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAMnF;AAED,0DAA0D;AAC1D,wBAAgB,aAAa,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,CAElF;AAED,mDAAmD;AACnD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAEnG;AAED,sDAAsD;AACtD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,SAAS,GAAG,qBAAqB,GAAG,SAAS,CAEjH;AAED,0FAA0F;AAC1F,eAAO,MAAM,qBAAqB,EAAE,SAAS,SAAS,EAQrD,CAAC;AAEF,0FAA0F;AAC1F,eAAO,MAAM,kBAAkB,EAAE,SAAS,SAAS,EAQlD,CAAC"}

package/dist/core/types/registry.js

@@ -1,9 +1,8 @@
-import { FIELD_TYPES } from './values.js';
+import { FIELD_TYPES, PG_FIELD_TYPES } from './values.js';
 /**
  * Field-type registry — the single source for the engine's field-type
- * descriptors. Primitive types (scalar + relation + sequence) carry `base:
- * undefined`; semantic types (string subtypes, media, identity FKs) carry a
- * `base` they fully inherit (storage/describe/gen-types/MCP behaviour), plus a
+ * descriptors. PG-native types carry `base: undefined`; custom types may carry a
+ * `base` they fully inherit (storage/describe/gen-types/MCP behaviour) plus a
  * small `ui` hints block consumed by `@weave-kit/ui`. Schema-level gating lives
  * in the config `features.fieldTypes` whitelist (see validate.ts), NOT here.
  *
@@ -14,28 +13,36 @@ const registry = new Map();
 function define(descriptor) {
     registry.set(descriptor.name, descriptor);
 }
-// ---- primitives ----
-define({ name: FIELD_TYPES.STRING, scalar: true });
-define({ name: FIELD_TYPES.TEXT, scalar: true });
-define({ name: FIELD_TYPES.INTEGER, scalar: true });
-define({ name: FIELD_TYPES.NUMBER, scalar: true });
-define({ name: FIELD_TYPES.CURRENCY, scalar: true });
-define({ name: FIELD_TYPES.BOOLEAN, scalar: true });
-define({ name: FIELD_TYPES.DATETIME, scalar: true });
-define({ name: FIELD_TYPES.DATE, scalar: true });
-define({ name: FIELD_TYPES.JSON, scalar: true });
+// ---- PG-native value primitives (value scalars; PK-eligible as a base) ----
+for (const name of Object.values(PG_FIELD_TYPES))
+    define({ name, scalar: true });
+// value scalars PostgreSQL cannot use as a primary key: json/jsonb are not
+// comparable for a key and real/double/interval have no natural equality. They
+// stay scalar (usable as values, e.g. formula refs) but are not key-eligible.
+const KEY_INELIGIBLE = [
+    FIELD_TYPES.JSON,
+    FIELD_TYPES.JSONB,
+    FIELD_TYPES.INTERVAL,
+    FIELD_TYPES.REAL,
+    FIELD_TYPES.DOUBLE,
+];
+for (const name of KEY_INELIGIBLE)
+    define({ name, scalar: true, keyEligible: false });
+// ---- engine custom primitives (each may carry its own rules) ----
 define({ name: FIELD_TYPES.ENUM, scalar: true });
 define({ name: FIELD_TYPES.RELATION, relationLike: true });
 define({ name: FIELD_TYPES.DETAILS, relationLike: true });
 define({ name: FIELD_TYPES.MULTI_RELATION, relationLike: true });
 define({ name: FIELD_TYPES.SEQ_NO });
-// ---- semantic types (base delegation + ui hints + format hints) ----
+define({ name: FIELD_TYPES.CURRENCY, scalar: true });
+// ---- engine custom types with base delegation + ui/format hints ----
 define({ name: FIELD_TYPES.FIRST_NAME, base: FIELD_TYPES.STRING, scalar: true, ui: { visual: 'none' } });
 define({ name: FIELD_TYPES.LAST_NAME, base: FIELD_TYPES.STRING, scalar: true, ui: { visual: 'none' } });
 define({ name: FIELD_TYPES.EMAIL, base: FIELD_TYPES.STRING, scalar: true, ui: { visual: 'none' }, openApiFormat: 'email' });
 define({ name: FIELD_TYPES.PHONE, base: FIELD_TYPES.STRING, scalar: true, ui: { visual: 'none' } });
 define({ name: FIELD_TYPES.IMAGE, base: FIELD_TYPES.STRING, scalar: true, ui: { visual: 'image' }, openApiFormat: 'uri' });
-define({ name: FIELD_TYPES.PERSON, base: FIELD_TYPES.RELATION, relationLike: true, ui: { visual: 'avatar' } });
+// ---- identity FK types (relation-like; implicit target = the identity objects) ----
+define({ name: FIELD_TYPES.USER, base: FIELD_TYPES.RELATION, relationLike: true, ui: { visual: 'avatar' } });
 define({ name: FIELD_TYPES.DEPARTMENT, base: FIELD_TYPES.RELATION, relationLike: true, ui: { visual: 'icon' } });
 /** the default registry: every engine built-in type (immutable by convention) */
 export const DEFAULT_FIELD_TYPE_REGISTRY = registry;
@@ -63,13 +70,23 @@ export function isRelationLike(registry, type) {
         return desc.relationLike;
     return registry.get(fieldBase(registry, type))?.relationLike === true;
 }
-/** true for a field type that can be a primary key */
+/** true for a scalar value type (see `isKeyEligible` for primary-key use) */
 export function isScalarFieldType(registry, type) {
     const desc = registry.get(type);
     if (desc?.scalar !== undefined)
         return desc.scalar;
     return registry.get(fieldBase(registry, type))?.scalar === true;
 }
+/** true for a field type eligible as a primary key (scalar + key-eligible) */
+export function isKeyEligible(registry, type) {
+    const desc = registry.get(type);
+    if (desc?.keyEligible !== undefined)
+        return desc.keyEligible;
+    const base = desc?.base;
+    if (base !== undefined)
+        return registry.get(base)?.keyEligible !== false;
+    return isScalarFieldType(registry, type);
+}
 /** the frontend visual hint for a type (single source) */
 export function fieldUiVisual(registry, type) {
     return registry.get(type)?.ui?.visual ?? 'none';
@@ -82,31 +99,24 @@ export function fieldOpenApiFormat(registry, type) {
 export function describeFieldType(registry, type) {
     return registry.get(type);
 }
-/** engine primitives — always allowed by the default whitelist. */
+/** always-enabled types — every scaffold preset (including `agent`) starts from these. */
 export const PRIMITIVE_FIELD_TYPES = [
-    FIELD_TYPES.STRING,
-    FIELD_TYPES.TEXT,
-    FIELD_TYPES.INTEGER,
-    FIELD_TYPES.NUMBER,
-    FIELD_TYPES.CURRENCY,
-    FIELD_TYPES.BOOLEAN,
-    FIELD_TYPES.DATETIME,
-    FIELD_TYPES.DATE,
-    FIELD_TYPES.JSON,
+    ...Object.values(PG_FIELD_TYPES),
     FIELD_TYPES.ENUM,
     FIELD_TYPES.RELATION,
     FIELD_TYPES.DETAILS,
     FIELD_TYPES.MULTI_RELATION,
     FIELD_TYPES.SEQ_NO,
+    FIELD_TYPES.CURRENCY,
 ];
-/** semantic types that are gated by the config `features.fieldTypes` whitelist. */
-export const SEMANTIC_FIELD_TYPES = [
+/** opt-in types — the non-`agent` presets add these; `features.fieldTypes` gates them. */
+export const OPT_IN_FIELD_TYPES = [
     FIELD_TYPES.FIRST_NAME,
     FIELD_TYPES.LAST_NAME,
     FIELD_TYPES.EMAIL,
     FIELD_TYPES.PHONE,
     FIELD_TYPES.IMAGE,
-    FIELD_TYPES.PERSON,
+    FIELD_TYPES.USER,
     FIELD_TYPES.DEPARTMENT,
 ];
 //# sourceMappingURL=registry.js.map

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

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

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

@@ -5,17 +5,56 @@
  * `typeof X[keyof typeof X]`, so the value set lives in exactly one place.
  * Consumers import the const (runtime) or the derived type (compile-time).
  */
-/** every field type: scalar + relation + sequence */
-export declare const FIELD_TYPES: {
+/**
+ * PG-native field types: near 1:1 with a native PostgreSQL column type
+ * (aliases allowed, e.g. `string`→varchar, `number`→numeric, `double`→double
+ * precision). No engine-specific rules beyond the column mapping.
+ */
+export declare const PG_FIELD_TYPES: {
     readonly STRING: "string";
     readonly TEXT: "text";
+    readonly CHAR: "char";
+    readonly SMALLINT: "smallint";
     readonly INTEGER: "integer";
+    readonly BIGINT: "bigint";
     readonly NUMBER: "number";
-    readonly CURRENCY: "currency";
+    readonly REAL: "real";
+    readonly DOUBLE: "double";
     readonly BOOLEAN: "boolean";
-    readonly DATETIME: "datetime";
     readonly DATE: "date";
+    readonly TIME: "time";
+    readonly TIMETZ: "timetz";
+    readonly TIMESTAMP: "timestamp";
+    readonly TIMESTAMPTZ: "timestamptz";
+    readonly INTERVAL: "interval";
+    readonly UUID: "uuid";
     readonly JSON: "json";
+    readonly JSONB: "jsonb";
+};
+/**
+ * Engine-shipped custom field types (each may carry its own rules: enum options,
+ * relation target, currency code, identity target, …). External user/plugin
+ * registrations join this same category at runtime through the
+ * `FieldTypeRegistry` (namespaced), so only the engine-provided ones are
+ * enumerated statically here.
+ */
+export declare const BUILTIN_CUSTOM_FIELD_TYPES: {
+    readonly ENUM: "enum";
+    readonly RELATION: "relation";
+    readonly DETAILS: "details";
+    readonly MULTI_RELATION: "multiRelation";
+    readonly SEQ_NO: "seq_no";
+    readonly FIRST_NAME: "firstName";
+    readonly LAST_NAME: "lastName";
+    readonly EMAIL: "email";
+    readonly PHONE: "phone";
+    readonly IMAGE: "image";
+    readonly CURRENCY: "currency";
+    readonly USER: "user";
+    readonly DEPARTMENT: "department";
+};
+/** every field type: PG-native columns + engine-shipped custom types */
+export declare const FIELD_TYPES: {
     readonly ENUM: "enum";
     readonly RELATION: "relation";
     readonly DETAILS: "details";
@@ -26,8 +65,28 @@ export declare const FIELD_TYPES: {
     readonly EMAIL: "email";
     readonly PHONE: "phone";
     readonly IMAGE: "image";
-    readonly PERSON: "person";
+    readonly CURRENCY: "currency";
+    readonly USER: "user";
     readonly DEPARTMENT: "department";
+    readonly STRING: "string";
+    readonly TEXT: "text";
+    readonly CHAR: "char";
+    readonly SMALLINT: "smallint";
+    readonly INTEGER: "integer";
+    readonly BIGINT: "bigint";
+    readonly NUMBER: "number";
+    readonly REAL: "real";
+    readonly DOUBLE: "double";
+    readonly BOOLEAN: "boolean";
+    readonly DATE: "date";
+    readonly TIME: "time";
+    readonly TIMETZ: "timetz";
+    readonly TIMESTAMP: "timestamp";
+    readonly TIMESTAMPTZ: "timestamptz";
+    readonly INTERVAL: "interval";
+    readonly UUID: "uuid";
+    readonly JSON: "json";
+    readonly JSONB: "jsonb";
 };
 /** a built-in field type (the closed set the engine ships) */
 export type BuiltinFieldType = typeof FIELD_TYPES[keyof typeof FIELD_TYPES];
@@ -37,25 +96,12 @@ export type BuiltinFieldType = typeof FIELD_TYPES[keyof typeof FIELD_TYPES];
  * names; behaviour is resolved through the `FieldTypeRegistry` (base delegation).
  */
 export type FieldType = BuiltinFieldType | (string & {});
-/** scalar subset of FIELD_TYPES (primary key only allows scalar types) */
-export declare const SCALAR_FIELD_TYPES: {
-    readonly STRING: "string";
-    readonly TEXT: "text";
-    readonly INTEGER: "integer";
-    readonly NUMBER: "number";
-    readonly CURRENCY: "currency";
-    readonly BOOLEAN: "boolean";
-    readonly DATETIME: "datetime";
-    readonly DATE: "date";
-    readonly JSON: "json";
-    readonly ENUM: "enum";
-    readonly FIRST_NAME: "firstName";
-    readonly LAST_NAME: "lastName";
-    readonly EMAIL: "email";
-    readonly PHONE: "phone";
-    readonly IMAGE: "image";
+/** the engine identity objects targeted by the `user`/`department` field types */
+export declare const IDENTITY_OBJECT_NAMES: {
+    readonly USER: "weavekit_user";
+    readonly DEPARTMENT: "weavekit_department";
 };
-export type ScalarFieldType = typeof SCALAR_FIELD_TYPES[keyof typeof SCALAR_FIELD_TYPES];
+export type IdentityObjectName = typeof IDENTITY_OBJECT_NAMES[keyof typeof IDENTITY_OBJECT_NAMES];
 /** FK delete behavior for `relation` fields (default restrict) */
 export declare const ON_DELETE_ACTIONS: {
     readonly CASCADE: "cascade";
@@ -63,19 +109,31 @@ export declare const ON_DELETE_ACTIONS: {
     readonly SET_NULL: "set_null";
 };
 export type OnDeleteAction = typeof ON_DELETE_ACTIONS[keyof typeof ON_DELETE_ACTIONS];
-/** row-level read scope for RBAC */
+/** row-level read/manage scope for RBAC */
 export declare const READ_SCOPES: {
     readonly OWN: "own";
-    readonly TEAM: "team";
+    readonly DEPARTMENT: "department";
     readonly ALL: "all";
 };
 export type ReadScope = typeof READ_SCOPES[keyof typeof READ_SCOPES];
-/** field markers that declare row-level scope columns (ownership/team) */
+/** field markers that declare row-level scope columns (ownership/department) */
 export declare const ROW_SCOPE_MARKERS: {
     readonly OWNERSHIP: "ownership";
-    readonly TEAM: "team";
+    readonly DEPARTMENT: "department";
 };
 export type RowScopeMarker = typeof ROW_SCOPE_MARKERS[keyof typeof ROW_SCOPE_MARKERS];
+/**
+ * where a scope column's values come from:
+ * - `internal` — ids of the engine identity directory (`weavekit_*` uuids)
+ * - `external` — ids from the identity source (translated via `external_id`)
+ */
+export declare const SCOPE_SOURCES: {
+    readonly INTERNAL: "internal";
+    readonly EXTERNAL: "external";
+};
+export type ScopeSource = typeof SCOPE_SOURCES[keyof typeof SCOPE_SOURCES];
+/** object names reserved by the engine (system objects + engine-managed tables) */
+export declare const RESERVED_OBJECT_PREFIX = "weavekit_";
 /** index access method */
 export declare const INDEX_TYPES: {
     readonly BTREE: "btree";
@@ -83,6 +141,11 @@ export declare const INDEX_TYPES: {
     readonly GIST: "gist";
 };
 export type IndexType = typeof INDEX_TYPES[keyof typeof INDEX_TYPES];
+/** declarative table-level constraint kinds */
+export declare const CONSTRAINT_TYPES: {
+    readonly UNIQUE: "unique";
+};
+export type ConstraintType = typeof CONSTRAINT_TYPES[keyof typeof CONSTRAINT_TYPES];
 /** seq_no counter restart strategy */
 export declare const SEQUENCE_CYCLES: {
     readonly NONE: "none";
@@ -104,6 +167,18 @@ export declare const DETAILS_COLUMNS: {
     readonly PARENT_IDX: "parent_idx";
 };
 export type DetailsColumn = typeof DETAILS_COLUMNS[keyof typeof DETAILS_COLUMNS];
+/**
+ * Engine-managed record instance status (`weave_status`). The workflow runtime
+ * drives transitions between these; a record with no engine metadata defaults
+ * to `draft`.
+ */
+export declare const WEAVE_STATUS: {
+    readonly DRAFT: "draft";
+    readonly RUNNING: "running";
+    readonly EFFECTIVE: "effective";
+    readonly CANCELED: "canceled";
+};
+export type WeaveStatus = typeof WEAVE_STATUS[keyof typeof WEAVE_STATUS];
 /** relation edge kinds in the normalized RelationGraph */
 export declare const RELATION_KINDS: {
     readonly BELONGS_TO: "belongsTo";

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

@@ -1 +1 @@
-{"version":3,"file":"values.d.ts","sourceRoot":"","sources":["../../../src/core/types/values.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,qDAAqD;AACrD,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;CAyBd,CAAC;AACX,8DAA8D;AAC9D,MAAM,MAAM,gBAAgB,GAAG,OAAO,WAAW,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAC5E;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,gBAAgB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEzD,0EAA0E;AAC1E,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;CAgBrB,CAAC;AACX,MAAM,MAAM,eAAe,GAAG,OAAO,kBAAkB,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAEzF,kEAAkE;AAClE,eAAO,MAAM,iBAAiB;;;;CAIpB,CAAC;AACX,MAAM,MAAM,cAAc,GAAG,OAAO,iBAAiB,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC;AAEtF,oCAAoC;AACpC,eAAO,MAAM,WAAW;;;;CAId,CAAC;AACX,MAAM,MAAM,SAAS,GAAG,OAAO,WAAW,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAErE,0EAA0E;AAC1E,eAAO,MAAM,iBAAiB;;;CAGpB,CAAC;AACX,MAAM,MAAM,cAAc,GAAG,OAAO,iBAAiB,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC;AAEtF,0BAA0B;AAC1B,eAAO,MAAM,WAAW;;;;CAId,CAAC;AACX,MAAM,MAAM,SAAS,GAAG,OAAO,WAAW,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAErE,sCAAsC;AACtC,eAAO,MAAM,eAAe;;;CAGlB,CAAC;AACX,MAAM,MAAM,aAAa,GAAG,OAAO,eAAe,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC;AAEjF,6DAA6D;AAC7D,eAAO,MAAM,eAAe;;;;;CAKlB,CAAC;AACX,MAAM,MAAM,aAAa,GAAG,OAAO,eAAe,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC;AAEjF,iEAAiE;AACjE,eAAO,MAAM,eAAe;;;;CAIlB,CAAC;AACX,MAAM,MAAM,aAAa,GAAG,OAAO,eAAe,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC;AAEjF,0DAA0D;AAC1D,eAAO,MAAM,cAAc;;;;CAIjB,CAAC;AACX,MAAM,MAAM,YAAY,GAAG,OAAO,cAAc,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC"}
+{"version":3,"file":"values.d.ts","sourceRoot":"","sources":["../../../src/core/types/values.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;CAoBjB,CAAC;AAEX;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;CAc7B,CAAC;AAEX,wEAAwE;AACxE,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAGd,CAAC;AACX,8DAA8D;AAC9D,MAAM,MAAM,gBAAgB,GAAG,OAAO,WAAW,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAC5E;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,gBAAgB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEzD,kFAAkF;AAClF,eAAO,MAAM,qBAAqB;;;CAGxB,CAAC;AACX,MAAM,MAAM,kBAAkB,GAAG,OAAO,qBAAqB,CAAC,MAAM,OAAO,qBAAqB,CAAC,CAAC;AAElG,kEAAkE;AAClE,eAAO,MAAM,iBAAiB;;;;CAIpB,CAAC;AACX,MAAM,MAAM,cAAc,GAAG,OAAO,iBAAiB,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC;AAEtF,2CAA2C;AAC3C,eAAO,MAAM,WAAW;;;;CAId,CAAC;AACX,MAAM,MAAM,SAAS,GAAG,OAAO,WAAW,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAErE,gFAAgF;AAChF,eAAO,MAAM,iBAAiB;;;CAGpB,CAAC;AACX,MAAM,MAAM,cAAc,GAAG,OAAO,iBAAiB,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC;AAEtF;;;;GAIG;AACH,eAAO,MAAM,aAAa;;;CAGhB,CAAC;AACX,MAAM,MAAM,WAAW,GAAG,OAAO,aAAa,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC;AAE3E,mFAAmF;AACnF,eAAO,MAAM,sBAAsB,cAAc,CAAC;AAElD,0BAA0B;AAC1B,eAAO,MAAM,WAAW;;;;CAId,CAAC;AACX,MAAM,MAAM,SAAS,GAAG,OAAO,WAAW,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAErE,+CAA+C;AAC/C,eAAO,MAAM,gBAAgB;;CAEnB,CAAC;AACX,MAAM,MAAM,cAAc,GAAG,OAAO,gBAAgB,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AAEpF,sCAAsC;AACtC,eAAO,MAAM,eAAe;;;CAGlB,CAAC;AACX,MAAM,MAAM,aAAa,GAAG,OAAO,eAAe,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC;AAEjF,6DAA6D;AAC7D,eAAO,MAAM,eAAe;;;;;CAKlB,CAAC;AACX,MAAM,MAAM,aAAa,GAAG,OAAO,eAAe,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC;AAEjF,iEAAiE;AACjE,eAAO,MAAM,eAAe;;;;CAIlB,CAAC;AACX,MAAM,MAAM,aAAa,GAAG,OAAO,eAAe,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC;AAEjF;;;;GAIG;AACH,eAAO,MAAM,YAAY;;;;;CAKf,CAAC;AACX,MAAM,MAAM,WAAW,GAAG,OAAO,YAAY,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AAEzE,0DAA0D;AAC1D,eAAO,MAAM,cAAc;;;;CAIjB,CAAC;AACX,MAAM,MAAM,YAAY,GAAG,OAAO,cAAc,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC"}

package/dist/core/types/values.js

@@ -5,50 +5,63 @@
  * `typeof X[keyof typeof X]`, so the value set lives in exactly one place.
  * Consumers import the const (runtime) or the derived type (compile-time).
  */
-/** every field type: scalar + relation + sequence */
-export const FIELD_TYPES = {
+/**
+ * PG-native field types: near 1:1 with a native PostgreSQL column type
+ * (aliases allowed, e.g. `string`→varchar, `number`→numeric, `double`→double
+ * precision). No engine-specific rules beyond the column mapping.
+ */
+export const PG_FIELD_TYPES = {
     STRING: 'string',
     TEXT: 'text',
+    CHAR: 'char',
+    SMALLINT: 'smallint',
     INTEGER: 'integer',
+    BIGINT: 'bigint',
     NUMBER: 'number',
-    CURRENCY: 'currency',
+    REAL: 'real',
+    DOUBLE: 'double',
     BOOLEAN: 'boolean',
-    DATETIME: 'datetime',
     DATE: 'date',
+    TIME: 'time',
+    TIMETZ: 'timetz',
+    TIMESTAMP: 'timestamp',
+    TIMESTAMPTZ: 'timestamptz',
+    INTERVAL: 'interval',
+    UUID: 'uuid',
     JSON: 'json',
+    JSONB: 'jsonb',
+};
+/**
+ * Engine-shipped custom field types (each may carry its own rules: enum options,
+ * relation target, currency code, identity target, …). External user/plugin
+ * registrations join this same category at runtime through the
+ * `FieldTypeRegistry` (namespaced), so only the engine-provided ones are
+ * enumerated statically here.
+ */
+export const BUILTIN_CUSTOM_FIELD_TYPES = {
     ENUM: 'enum',
     RELATION: 'relation',
     DETAILS: 'details',
     MULTI_RELATION: 'multiRelation',
     SEQ_NO: 'seq_no',
-    // string subtypes (first/last name, contact) and media (image/asset)
     FIRST_NAME: 'firstName',
     LAST_NAME: 'lastName',
     EMAIL: 'email',
     PHONE: 'phone',
     IMAGE: 'image',
-    // identity FK to the internal address-book/person object (relation-like; not scalar)
-    PERSON: 'person',
-    // identity FK to the internal department/organization object (relation-like; not scalar)
+    CURRENCY: 'currency',
+    USER: 'user',
     DEPARTMENT: 'department',
 };
-/** scalar subset of FIELD_TYPES (primary key only allows scalar types) */
-export const SCALAR_FIELD_TYPES = {
-    STRING: 'string',
-    TEXT: 'text',
-    INTEGER: 'integer',
-    NUMBER: 'number',
-    CURRENCY: 'currency',
-    BOOLEAN: 'boolean',
-    DATETIME: 'datetime',
-    DATE: 'date',
-    JSON: 'json',
-    ENUM: 'enum',
-    FIRST_NAME: 'firstName',
-    LAST_NAME: 'lastName',
-    EMAIL: 'email',
-    PHONE: 'phone',
-    IMAGE: 'image',
+/** every field type: PG-native columns + engine-shipped custom types */
+export const FIELD_TYPES = {
+    ...PG_FIELD_TYPES,
+    ...BUILTIN_CUSTOM_FIELD_TYPES,
+};
+/** the engine identity objects targeted by the `user`/`department` field types */
+export const IDENTITY_OBJECT_NAMES = {
+    USER: 'weavekit_user',
+    DEPARTMENT: 'weavekit_department',
 };
 /** FK delete behavior for `relation` fields (default restrict) */
 export const ON_DELETE_ACTIONS = {
@@ -56,23 +69,38 @@ export const ON_DELETE_ACTIONS = {
     RESTRICT: 'restrict',
     SET_NULL: 'set_null',
 };
-/** row-level read scope for RBAC */
+/** row-level read/manage scope for RBAC */
 export const READ_SCOPES = {
     OWN: 'own',
-    TEAM: 'team',
+    DEPARTMENT: 'department',
     ALL: 'all',
 };
-/** field markers that declare row-level scope columns (ownership/team) */
+/** field markers that declare row-level scope columns (ownership/department) */
 export const ROW_SCOPE_MARKERS = {
     OWNERSHIP: 'ownership',
-    TEAM: 'team',
+    DEPARTMENT: 'department',
+};
+/**
+ * where a scope column's values come from:
+ * - `internal` — ids of the engine identity directory (`weavekit_*` uuids)
+ * - `external` — ids from the identity source (translated via `external_id`)
+ */
+export const SCOPE_SOURCES = {
+    INTERNAL: 'internal',
+    EXTERNAL: 'external',
 };
+/** object names reserved by the engine (system objects + engine-managed tables) */
+export const RESERVED_OBJECT_PREFIX = 'weavekit_';
 /** index access method */
 export const INDEX_TYPES = {
     BTREE: 'btree',
     GIN: 'gin',
     GIST: 'gist',
 };
+/** declarative table-level constraint kinds */
+export const CONSTRAINT_TYPES = {
+    UNIQUE: 'unique',
+};
 /** seq_no counter restart strategy */
 export const SEQUENCE_CYCLES = {
     NONE: 'none',
@@ -91,6 +119,17 @@ export const DETAILS_COLUMNS = {
     PARENT_TYPE: 'parent_type',
     PARENT_IDX: 'parent_idx',
 };
+/**
+ * Engine-managed record instance status (`weave_status`). The workflow runtime
+ * drives transitions between these; a record with no engine metadata defaults
+ * to `draft`.
+ */
+export const WEAVE_STATUS = {
+    DRAFT: 'draft',
+    RUNNING: 'running',
+    EFFECTIVE: 'effective',
+    CANCELED: 'canceled',
+};
 /** relation edge kinds in the normalized RelationGraph */
 export const RELATION_KINDS = {
     BELONGS_TO: 'belongsTo',

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

@@ -1 +1 @@
-{"version":3,"file":"values.js","sourceRoot":"","sources":["../../../src/core/types/values.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,qDAAqD;AACrD,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,UAAU;IACpB,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,SAAS;IAClB,cAAc,EAAE,eAAe;IAC/B,MAAM,EAAE,QAAQ;IAChB,qEAAqE;IACrE,UAAU,EAAE,WAAW;IACvB,SAAS,EAAE,UAAU;IACrB,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,qFAAqF;IACrF,MAAM,EAAE,QAAQ;IAChB,yFAAyF;IACzF,UAAU,EAAE,YAAY;CAChB,CAAC;AAUX,0EAA0E;AAC1E,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,UAAU;IACpB,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,UAAU,EAAE,WAAW;IACvB,SAAS,EAAE,UAAU;IACrB,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;CACN,CAAC;AAGX,kEAAkE;AAClE,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;CACZ,CAAC;AAGX,oCAAoC;AACpC,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,GAAG,EAAE,KAAK;IACV,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,KAAK;CACF,CAAC;AAGX,0EAA0E;AAC1E,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,SAAS,EAAE,WAAW;IACtB,IAAI,EAAE,MAAM;CACJ,CAAC;AAGX,0BAA0B;AAC1B,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,KAAK,EAAE,OAAO;IACd,GAAG,EAAE,KAAK;IACV,IAAI,EAAE,MAAM;CACJ,CAAC;AAGX,sCAAsC;AACtC,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;CACJ,CAAC;AAGX,6DAA6D;AAC7D,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,GAAG,EAAE,KAAK;IACV,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;IACd,GAAG,EAAE,KAAK;CACF,CAAC;AAGX,iEAAiE;AACjE,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,SAAS,EAAE,WAAW;IACtB,WAAW,EAAE,aAAa;IAC1B,UAAU,EAAE,YAAY;CAChB,CAAC;AAGX,0DAA0D;AAC1D,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,UAAU,EAAE,WAAW;IACvB,QAAQ,EAAE,SAAS;IACnB,cAAc,EAAE,eAAe;CACvB,CAAC"}
+{"version":3,"file":"values.js","sourceRoot":"","sources":["../../../src/core/types/values.ts"],"names":[],"mappings":"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"}