@weave-kit/engine 0.5.0 → 0.7.0

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

@@ -5,17 +5,40 @@
  * `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";
@@ -26,9 +49,45 @@ 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";
 };
+/** every field type: PG-native columns + engine-shipped custom types */
+export declare const 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";
+    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";
@@ -109,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,+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,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,17 +69,28 @@ 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',
@@ -95,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,+CAA+C;AAC/C,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,MAAM,EAAE,QAAQ;CACR,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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"}

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

@@ -0,0 +1,140 @@
+/**
+ * Declarative single-line node-chain workflow (`objects/<name>/workflow.json`).
+ * Pure types — zero runtime dependencies (core contract layer).
+ *
+ * Format v2 replaces the v1 state-marker machine (`stateField` + `states[]` +
+ * `transitions[]`) with an ordered `nodes[]` chain driven by an implicit start
+ * node. Instance/step/workitem state lives in engine tables, never in the
+ * customer's columns (see the C-phase plan).
+ */
+/** on-disk `workflow.json` format version (single source of truth) */
+export declare const WORKFLOW_FORMAT_VERSION: 2;
+/** synthetic node id of the implicit start (发起) node — never authored */
+export declare const WORKFLOW_START_NODE = "__start__";
+/** node kinds (single source of truth) */
+export declare const WORKFLOW_NODE_KINDS: {
+    readonly APPROVE: "approve";
+    readonly NOTIFY: "notify";
+};
+export type WorkflowNodeKind = (typeof WORKFLOW_NODE_KINDS)[keyof typeof WORKFLOW_NODE_KINDS];
+/** how a node's assignees complete it (single source of truth) */
+export declare const WORKFLOW_ASSIGN_MODES: {
+    /** 或签: the first decision settles the node */
+    readonly ANY: "any";
+    /** 会签: every assignee must approve */
+    readonly ALL: "all";
+};
+export type WorkflowAssignMode = (typeof WORKFLOW_ASSIGN_MODES)[keyof typeof WORKFLOW_ASSIGN_MODES];
+/** the actions a node timeout may auto-fire (single source of truth) */
+export declare const WORKFLOW_TIMEOUT_ACTIONS: {
+    readonly APPROVE: "approve";
+    readonly REJECT: "reject";
+};
+export type WorkflowTimeoutAction = (typeof WORKFLOW_TIMEOUT_ACTIONS)[keyof typeof WORKFLOW_TIMEOUT_ACTIONS];
+/** how long a node may be held before its timeout fires, and what to do then */
+export interface WorkflowTimeout {
+    /** duration string: `<n>` with optional unit `ms|s|m|h|d|w` (bare number = ms) */
+    after: string;
+    /** action auto-fired on expiry; absent = only dispatch the `onTimeout` hook */
+    action?: WorkflowTimeoutAction;
+}
+/** who acts at a node and how the node completes */
+export interface WorkflowAssign {
+    /** roles whose members resolve to the node's assignees (required, non-empty) */
+    roles: string[];
+    /** 或签 (`any`, default) | 会签 (`all`); `notify` nodes keep `any` */
+    mode?: WorkflowAssignMode;
+}
+/** one node in the single-line chain */
+export interface WorkflowNode {
+    /** snake_case node id, unique within the chain */
+    id: string;
+    /** `approve` (default) | `notify` (抄送: no quorum, advances immediately) */
+    kind?: WorkflowNodeKind;
+    /** display names keyed by locale, e.g. { en: 'Finance', zh: '财务审批' } */
+    name?: Record<string, string>;
+    description?: string;
+    /** roles that resolve to the node's assignees (required) */
+    assign: WorkflowAssign;
+    /** on reject, roll back to this earlier node id; absent = the start node */
+    onReject?: string;
+    /** on withdraw, roll back to this earlier node id; absent = the start node */
+    onWithdraw?: string;
+    /** when true, the action at this node must be approved through the approval queue before it fires */
+    requiresApproval?: boolean;
+    /** node-level timeout (approve nodes only) */
+    onTimeout?: WorkflowTimeout;
+}
+/** validated workflow definition attached to an object */
+export interface WorkflowDefinition {
+    /** on-disk `workflow.json` format version */
+    schemaVersion?: number;
+    /**
+     * author-managed definition revision (an arbitrary positive integer, distinct
+     * from the on-disk `schemaVersion`). Surfaced in the descriptor / transition
+     * events + audit so history stays interpretable after a definition changes.
+     * See `workflowHash` for the exact content identity (instance pinning).
+     */
+    version?: number;
+    /** the ordered single-line node chain (the start node is implicit) */
+    nodes: WorkflowNode[];
+}
+/** `weavekit.config.ts -> subsystems.workflow` */
+export interface EngineWorkflowConfig {
+    enabled?: boolean;
+    /** scheduler poll interval in ms; defaults to `WORKFLOW_TIMER_DEFAULTS.pollMs` */
+    pollMs?: number;
+    /** timers claimed per tick; defaults to `WORKFLOW_TIMER_DEFAULTS.batchSize` */
+    batchSize?: number;
+    /** pluggable durable timer backend (defaults to the PG `weavekit_workflow_timers` store) */
+    backend?: WorkflowBackend;
+}
+/** scheduler defaults — single source of truth (as const, see AGENTS.md) */
+export declare const WORKFLOW_TIMER_DEFAULTS: {
+    readonly pollMs: 30000;
+    readonly batchSize: 50;
+};
+/** one armed timeout for a record's current step */
+export interface WorkflowTimer {
+    object: string;
+    id: string;
+    /** the current node id the timeout is armed for */
+    nodeId: string;
+    dueAt: Date;
+    /** semantic hash of the definition the timer was armed under */
+    workflowHash?: string;
+}
+/**
+ * Durable timer store — the engine ships a PostgreSQL default
+ * (`weavekit_workflow_timers`, claimed with `FOR UPDATE SKIP LOCKED`). The
+ * seam lets an enterprise backend (e.g. Redis/HA coordination) plug in without
+ * forking core; the engine never imports a non-PG implementation.
+ */
+export interface WorkflowTimerStore {
+    /** attach/refresh the single timer for a record (one per record) */
+    schedule(timer: WorkflowTimer): Promise<void>;
+    /** remove any timer for the record */
+    cancel(object: string, id: string): Promise<void>;
+    /** atomically take up to `limit` due timers (multi-instance safe) */
+    claimDue(limit: number, now: Date): Promise<WorkflowTimer[]>;
+    /** finalize a claimed timer (idempotent) */
+    complete(timer: WorkflowTimer): Promise<void>;
+}
+/** umbrella seam: an alternative workflow backend (enterprise), default is the engine's PG store */
+export interface WorkflowBackend {
+    readonly timerStore: WorkflowTimerStore;
+}
+/**
+ * Narrow timer handle injected into data-access: writes re-arm/cancel the
+ * record's timer on node changes without knowing the scheduler/backend. The
+ * engine wires the real scheduler at assembly (a no-op proxy before it exists).
+ */
+export interface WorkflowTimerSync {
+    /** (re)arm the timer for the record's new node/state, or cancel when it has no `onTimeout` */
+    sync(object: string, id: string, state: string): Promise<void>;
+    /** cancel any timer for the record */
+    cancel(object: string, id: string): Promise<void>;
+}
+/** parse a duration string (`90s`, `30m`, `12h`, `7d`, `2w`, or a bare number of ms) */
+export declare function parseDuration(input: string): number | undefined;
+//# sourceMappingURL=workflow.d.ts.map

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

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

package/dist/core/types/workflow.js

@@ -0,0 +1,49 @@
+/**
+ * Declarative single-line node-chain workflow (`objects/<name>/workflow.json`).
+ * Pure types — zero runtime dependencies (core contract layer).
+ *
+ * Format v2 replaces the v1 state-marker machine (`stateField` + `states[]` +
+ * `transitions[]`) with an ordered `nodes[]` chain driven by an implicit start
+ * node. Instance/step/workitem state lives in engine tables, never in the
+ * customer's columns (see the C-phase plan).
+ */
+/** on-disk `workflow.json` format version (single source of truth) */
+export const WORKFLOW_FORMAT_VERSION = 2;
+/** synthetic node id of the implicit start (发起) node — never authored */
+export const WORKFLOW_START_NODE = '__start__';
+/** node kinds (single source of truth) */
+export const WORKFLOW_NODE_KINDS = {
+    APPROVE: 'approve',
+    NOTIFY: 'notify',
+};
+/** how a node's assignees complete it (single source of truth) */
+export const WORKFLOW_ASSIGN_MODES = {
+    /** 或签: the first decision settles the node */
+    ANY: 'any',
+    /** 会签: every assignee must approve */
+    ALL: 'all',
+};
+/** the actions a node timeout may auto-fire (single source of truth) */
+export const WORKFLOW_TIMEOUT_ACTIONS = {
+    APPROVE: 'approve',
+    REJECT: 'reject',
+};
+/** scheduler defaults — single source of truth (as const, see AGENTS.md) */
+export const WORKFLOW_TIMER_DEFAULTS = {
+    pollMs: 30000,
+    batchSize: 50,
+};
+/** duration units in milliseconds (single source of truth) */
+const DURATION_UNITS = { ms: 1, s: 1000, m: 60_000, h: 3_600_000, d: 86_400_000, w: 604_800_000 };
+/** parse a duration string (`90s`, `30m`, `12h`, `7d`, `2w`, or a bare number of ms) */
+export function parseDuration(input) {
+    const match = /^(\d+)(ms|s|m|h|d|w)?$/.exec(input.trim());
+    if (match === null)
+        return undefined;
+    const amount = Number(match[1]);
+    if (!Number.isFinite(amount) || amount <= 0)
+        return undefined;
+    const unit = (match[2] ?? 'ms');
+    return amount * DURATION_UNITS[unit];
+}
+//# sourceMappingURL=workflow.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../../src/core/types/workflow.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,sEAAsE;AACtE,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAU,CAAC;AAElD,yEAAyE;AACzE,MAAM,CAAC,MAAM,mBAAmB,GAAG,WAAW,CAAC;AAE/C,0CAA0C;AAC1C,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,QAAQ;CACR,CAAC;AAGX,kEAAkE;AAClE,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,8CAA8C;IAC9C,GAAG,EAAE,KAAK;IACV,sCAAsC;IACtC,GAAG,EAAE,KAAK;CACF,CAAC;AAGX,wEAAwE;AACxE,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,QAAQ;CACR,CAAC;AAmEX,4EAA4E;AAC5E,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,MAAM,EAAE,KAAK;IACb,SAAS,EAAE,EAAE;CACL,CAAC;AA+CX,8DAA8D;AAC9D,MAAM,cAAc,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW,EAAW,CAAC;AAE3G,wFAAwF;AACxF,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,MAAM,KAAK,GAAG,wBAAwB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1D,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACrC,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAChC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9D,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAgC,CAAC;IAC/D,OAAO,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;AACvC,CAAC"}

package/dist/index.d.ts

@@ -2,6 +2,7 @@ import type { EngineConfig, WeaveKitEngine } from './runtime/engine.js';
 export * from './core/index.js';
 export * from './core/api/index.js';
 export * from './runtime/data-access/index.js';
+export * from './runtime/identity/index.js';
 export * from './runtime/git/index.js';
 export * from './runtime/tools/index.js';
 export * from './runtime/proxy/index.js';
@@ -19,6 +20,7 @@ export type { ScaffoldProjectOptions, ScaffoldProjectResult } from './cli/scaffo
 export { loadFieldTypesDir, normalizeFieldTypeRegistration, resolveFieldTypeRegistry } from './runtime/fieldtypes/index.js';
 export type { LoadedFieldType } from './runtime/fieldtypes/index.js';
 export { PROJECT_TYPES } from './cli/types/values.js';
+export { PROJECT_TYPE_DEFINITIONS, projectTypeDef, isBusinessUI } from './cli/project-types/manifest.js';
 export type { ProjectType } from './cli/types/values.js';
 export { version } from './version.js';
 /**

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAKxE,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAC3F,YAAY,EACV,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,GAChB,MAAM,6BAA6B,CAAC;AACrC,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC1G,YAAY,EACV,YAAY,EACZ,oBAAoB,EACpB,WAAW,EACX,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AACvF,OAAO,EAAE,iBAAiB,EAAE,8BAA8B,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAC5H,YAAY,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC,CAwDhF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAKxE,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAC3F,YAAY,EACV,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,GAChB,MAAM,6BAA6B,CAAC;AACrC,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC1G,YAAY,EACV,YAAY,EACZ,oBAAoB,EACpB,WAAW,EACX,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AACvF,OAAO,EAAE,iBAAiB,EAAE,8BAA8B,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAC5H,YAAY,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACzG,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC,CA0DhF"}

package/dist/index.js

@@ -4,10 +4,11 @@ import { resolveFieldTypeRegistry } from './runtime/fieldtypes/index.js';
 import { buildEngineFromRegistry, resolveLocale } from './runtime/engine.js';
 import { resolve } from 'node:path';
 // Stable surface (contract): app/integration authors depend on these. Internals
-// live in `./experimental.js` (unstable) or stay unexported — see docs/reference/public-api.md.
+// live in `./experimental.js` (unstable) or stay unexported — see docs/04-reference/01-api/02-public-api.md.
 export * from './core/index.js';
 export * from './core/api/index.js';
 export * from './runtime/data-access/index.js';
+export * from './runtime/identity/index.js';
 export * from './runtime/git/index.js';
 export * from './runtime/tools/index.js';
 export * from './runtime/proxy/index.js';
@@ -20,6 +21,7 @@ export { buildOpenApiDocument, capabilitiesFromConfig } from './adapters/openapi
 export { scaffoldProject } from './cli/scaffold.js';
 export { loadFieldTypesDir, normalizeFieldTypeRegistration, resolveFieldTypeRegistry } from './runtime/fieldtypes/index.js';
 export { PROJECT_TYPES } from './cli/types/values.js';
+export { PROJECT_TYPE_DEFINITIONS, projectTypeDef, isBusinessUI } from './cli/project-types/manifest.js';
 export { version } from './version.js';
 /**
  * Assemble an engine from a config: load the schema from `schemaDir`
@@ -44,7 +46,7 @@ export async function createEngine(config) {
     if (config.migrate?.auto === true) {
         const sync = await syncSchema({
             dir,
-            databaseUrl: config.databaseUrl,
+            databaseUrl: config.migrationDatabaseUrl ?? config.databaseUrl,
             locale,
             allowedFieldTypes: config.features?.fieldTypes,
             fieldTypes,
@@ -61,7 +63,7 @@ export async function createEngine(config) {
             if (commit.committed && changes.length > 0) {
                 const author = await gitCommitAuthor(dir);
                 // reached only after a successful sync, which required a DB URL
-                const pool = createPool(config.databaseUrl ?? process.env.DATABASE_URL);
+                const pool = createPool(config.migrationDatabaseUrl ?? config.databaseUrl ?? process.env.DATABASE_URL);
                 try {
                     await recordSchemaChanges(pool, changes, sync.files, {
                         sha: commit.sha,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EACL,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,aAAa,EACb,mBAAmB,EACnB,UAAU,GACX,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE7E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,gFAAgF;AAChF,gGAAgG;AAChG,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAmB3F,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAAE,iBAAiB,EAAE,8BAA8B,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAE5H,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAGtD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAoB;IACrD,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,IAAI,GAAG,CAAC;IAEpC,6EAA6E;IAC7E,yEAAyE;IACzE,MAAM,UAAU,GAAG,MAAM,wBAAwB,CAAC;QAChD,GAAG,EAAE,MAAM,CAAC,UAAU,EAAE,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC;QAC3F,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,OAAO;QACnC,MAAM;KACP,CAAC,CAAC;IAEH,IAAI,QAAwB,CAAC;IAC7B,IAAI,MAAM,CAAC,OAAO,EAAE,IAAI,KAAK,IAAI,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC;YAC5B,GAAG;YACH,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,MAAM;YACN,iBAAiB,EAAE,MAAM,CAAC,QAAQ,EAAE,UAAU;YAC9C,UAAU;SACX,CAAC,CAAC;QACH,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QACzB,IAAI,MAAM,CAAC,MAAM,EAAE,IAAI,KAAK,IAAI,EAAE,CAAC;YACjC,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YAC5D,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC;gBAC9B,GAAG;gBACH,OAAO,EAAE,kBAAkB,CAAC,OAAO,CAAC;gBACpC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ;gBACjC,MAAM;aACP,CAAC,CAAC;YACH,IAAI,MAAM,CAAC,SAAS,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC3C,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC;gBAC1C,gEAAgE;gBAChE,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,YAAa,CAAC,CAAC;gBACzE,IAAI,CAAC;oBACH,MAAM,mBAAmB,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE;wBACnD,GAAG,EAAE,MAAM,CAAC,GAAG;wBACf,MAAM;wBACN,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO;qBAChC,CAAC,CAAC;gBACL,CAAC;wBAAS,CAAC;oBACT,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC;gBACnB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE;YACpD,MAAM;YACN,iBAAiB,EAAE,MAAM,CAAC,QAAQ,EAAE,UAAU;YAC9C,UAAU;SACX,CAAC,CAAC;QACH,MAAM,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAC9B,QAAQ,GAAG,MAAM,CAAC;IACpB,CAAC;IAED,OAAO,uBAAuB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AACnD,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/infrastructure/event/bus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bus.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/event/bus.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,QAAQ,EACb,KAAK,cAAc,EAIpB,MAAM,oCAAoC,CAAC;AAE5C,wBAAwB;AACxB,MAAM,WAAW,eAAe;IAC9B,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAQD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,eAAoB,GAAG,QAAQ,CAiDtE;AAED,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,GAAG,EAAE,QAAQ,GAAG,cAAc,CAkBzD"}
+{"version":3,"file":"bus.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/event/bus.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,QAAQ,EACb,KAAK,cAAc,EAIpB,MAAM,oCAAoC,CAAC;AAE5C,wBAAwB;AACxB,MAAM,WAAW,eAAe;IAC9B,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAQD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,eAAoB,GAAG,QAAQ,CAiDtE;AAED,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,GAAG,EAAE,QAAQ,GAAG,cAAc,CAwCzD"}