@weave-kit/engine 0.1.0

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

@@ -0,0 +1,107 @@
+/**
+ * Single source of truth for all enum-like string values.
+ *
+ * Every const below is `as const` and drives its union type via
+ * `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: {
+    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 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 PERSON: "person";
+    readonly DEPARTMENT: "department";
+};
+export type FieldType = typeof FIELD_TYPES[keyof typeof FIELD_TYPES];
+/** 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";
+};
+export type ScalarFieldType = typeof SCALAR_FIELD_TYPES[keyof typeof SCALAR_FIELD_TYPES];
+/** FK delete behavior for `relation` fields (default restrict) */
+export declare const ON_DELETE_ACTIONS: {
+    readonly CASCADE: "cascade";
+    readonly RESTRICT: "restrict";
+    readonly SET_NULL: "set_null";
+};
+export type OnDeleteAction = typeof ON_DELETE_ACTIONS[keyof typeof ON_DELETE_ACTIONS];
+/** row-level read scope for RBAC */
+export declare const READ_SCOPES: {
+    readonly OWN: "own";
+    readonly TEAM: "team";
+    readonly ALL: "all";
+};
+export type ReadScope = typeof READ_SCOPES[keyof typeof READ_SCOPES];
+/** field markers that declare row-level scope columns (ownership/team) */
+export declare const ROW_SCOPE_MARKERS: {
+    readonly OWNERSHIP: "ownership";
+    readonly TEAM: "team";
+};
+export type RowScopeMarker = typeof ROW_SCOPE_MARKERS[keyof typeof ROW_SCOPE_MARKERS];
+/** index access method */
+export declare const INDEX_TYPES: {
+    readonly BTREE: "btree";
+    readonly GIN: "gin";
+    readonly GIST: "gist";
+};
+export type IndexType = typeof INDEX_TYPES[keyof typeof INDEX_TYPES];
+/** seq_no counter restart strategy */
+export declare const SEQUENCE_CYCLES: {
+    readonly NONE: "none";
+    readonly YEAR: "year";
+};
+export type SequenceCycle = typeof SEQUENCE_CYCLES[keyof typeof SEQUENCE_CYCLES];
+/** placeholders allowed inside a seq_no `format` template */
+export declare const SEQUENCE_TOKENS: {
+    readonly SEQ: "seq";
+    readonly YEAR: "year";
+    readonly MONTH: "month";
+    readonly DAY: "day";
+};
+export type SequenceToken = typeof SEQUENCE_TOKENS[keyof typeof SEQUENCE_TOKENS];
+/** engine-managed columns auto-added to a details child table */
+export declare const DETAILS_COLUMNS: {
+    readonly PARENT_ID: "parent_id";
+    readonly PARENT_TYPE: "parent_type";
+    readonly PARENT_IDX: "parent_idx";
+};
+export type DetailsColumn = typeof DETAILS_COLUMNS[keyof typeof DETAILS_COLUMNS];
+/** relation edge kinds in the normalized RelationGraph */
+export declare const RELATION_KINDS: {
+    readonly BELONGS_TO: "belongsTo";
+    readonly HAS_MANY: "hasMany";
+    readonly MULTI_RELATION: "multiRelation";
+};
+export type RelationKind = typeof RELATION_KINDS[keyof typeof RELATION_KINDS];
+//# sourceMappingURL=values.d.ts.map

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

@@ -0,0 +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,MAAM,MAAM,SAAS,GAAG,OAAO,WAAW,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAErE,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"}

package/dist/core/types/values.js

@@ -0,0 +1,100 @@
+/**
+ * Single source of truth for all enum-like string values.
+ *
+ * Every const below is `as const` and drives its union type via
+ * `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 = {
+    STRING: 'string',
+    TEXT: 'text',
+    INTEGER: 'integer',
+    NUMBER: 'number',
+    CURRENCY: 'currency',
+    BOOLEAN: 'boolean',
+    DATETIME: 'datetime',
+    DATE: 'date',
+    JSON: 'json',
+    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 通讯录/人员对象 (relation-like; not scalar)
+    PERSON: 'person',
+    // identity FK to the internal 部门/组织对象 (relation-like; not scalar)
+    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',
+};
+/** FK delete behavior for `relation` fields (default restrict) */
+export const ON_DELETE_ACTIONS = {
+    CASCADE: 'cascade',
+    RESTRICT: 'restrict',
+    SET_NULL: 'set_null',
+};
+/** row-level read scope for RBAC */
+export const READ_SCOPES = {
+    OWN: 'own',
+    TEAM: 'team',
+    ALL: 'all',
+};
+/** field markers that declare row-level scope columns (ownership/team) */
+export const ROW_SCOPE_MARKERS = {
+    OWNERSHIP: 'ownership',
+    TEAM: 'team',
+};
+/** index access method */
+export const INDEX_TYPES = {
+    BTREE: 'btree',
+    GIN: 'gin',
+    GIST: 'gist',
+};
+/** seq_no counter restart strategy */
+export const SEQUENCE_CYCLES = {
+    NONE: 'none',
+    YEAR: 'year',
+};
+/** placeholders allowed inside a seq_no `format` template */
+export const SEQUENCE_TOKENS = {
+    SEQ: 'seq',
+    YEAR: 'year',
+    MONTH: 'month',
+    DAY: 'day',
+};
+/** engine-managed columns auto-added to a details child table */
+export const DETAILS_COLUMNS = {
+    PARENT_ID: 'parent_id',
+    PARENT_TYPE: 'parent_type',
+    PARENT_IDX: 'parent_idx',
+};
+/** relation edge kinds in the normalized RelationGraph */
+export const RELATION_KINDS = {
+    BELONGS_TO: 'belongsTo',
+    HAS_MANY: 'hasMany',
+    MULTI_RELATION: 'multiRelation',
+};
+//# sourceMappingURL=values.js.map

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

@@ -0,0 +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,mEAAmE;IACnE,MAAM,EAAE,QAAQ;IAChB,kEAAkE;IAClE,UAAU,EAAE,YAAY;CAChB,CAAC;AAGX,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"}

package/dist/experimental.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Experimental surface — `@weave-kit/engine/experimental`.
+ *
+ * Modules here are under active development and **may change in a minor
+ * release**. They are deliberately kept out of the stable `.` entry so the
+ * stable contract stays small and reviewable; import from here only when the
+ * stable surface does not cover your need. Everything not re-exported by `.`
+ * or `./experimental` is internal and not part of any contract.
+ */
+export * from './runtime/metadata/index.js';
+export * from './runtime/tunnel/index.js';
+export * from './adapters/ops/index.js';
+export * from './infrastructure/index.js';
+//# sourceMappingURL=experimental.d.ts.map

package/dist/experimental.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"experimental.d.ts","sourceRoot":"","sources":["../src/experimental.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC"}

package/dist/experimental.js

@@ -0,0 +1,14 @@
+/**
+ * Experimental surface — `@weave-kit/engine/experimental`.
+ *
+ * Modules here are under active development and **may change in a minor
+ * release**. They are deliberately kept out of the stable `.` entry so the
+ * stable contract stays small and reviewable; import from here only when the
+ * stable surface does not cover your need. Everything not re-exported by `.`
+ * or `./experimental` is internal and not part of any contract.
+ */
+export * from './runtime/metadata/index.js';
+export * from './runtime/tunnel/index.js';
+export * from './adapters/ops/index.js';
+export * from './infrastructure/index.js';
+//# sourceMappingURL=experimental.js.map

package/dist/experimental.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"experimental.js","sourceRoot":"","sources":["../src/experimental.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+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/git/index.js';
+export * from './runtime/tools/index.js';
+export * from './runtime/proxy/index.js';
+export * from './runtime/engine.js';
+export * from './adapters/auth/index.js';
+export * from './adapters/rest/index.js';
+export * from './adapters/mcp/index.js';
+export * from './adapters/events/index.js';
+export type { AuditEngine, AuditFilter, AuditQuery, AuditQueryResult } from './subsystems/audit/index.js';
+export type { LoadedScript, ResolvedScriptConfig, RpcExecutor, RpcRequest, SandboxBackend, SandboxCallResult, SandboxEntry, SandboxInstance, ScriptBridgeOptions, ScriptDispatcherOptions, } from './subsystems/script/index.js';
+export { scaffoldProject } from './cli/scaffold.js';
+export type { ScaffoldProjectOptions, ScaffoldProjectResult } from './cli/scaffold.js';
+export { PROJECT_TYPES } from './cli/types/values.js';
+export type { ProjectType } from './cli/types/values.js';
+export { version } from './version.js';
+/**
+ * Assemble an engine from a config: load the schema from `schemaDir`
+ * (default `.` — the project root's `objects/` directory), then build the
+ * RBAC-decorated data-access layer and expose the REST/MCP interfaces.
+ *
+ * Load-only by default: WeaveKit bridges your database without touching it —
+ * DDL (CREATE/ALTER) runs only when `migrate.auto` is enabled (greenfield) or
+ * via an explicit `weave migrate`.
+ */
+export declare function createEngine(config: EngineConfig): Promise<WeaveKitEngine>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAIxE,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,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,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,CA0ChF"}

package/dist/index.js

@@ -0,0 +1,72 @@
+import { createPool } from './core/index.js';
+import { autoCommit, buildCommitMessage, diffMetadata, gitCommitAuthor, loadSchemaDir, recordSchemaChanges, syncSchema, } from './runtime/git/index.js';
+import { buildEngineFromRegistry, resolveLocale } from './runtime/engine.js';
+// Stable surface (contract): app/integration authors depend on these. Internals
+// live in `./experimental.js` (unstable) or stay unexported — see docs/10-public-api.md.
+export * from './core/index.js';
+export * from './core/api/index.js';
+export * from './runtime/data-access/index.js';
+export * from './runtime/git/index.js';
+export * from './runtime/tools/index.js';
+export * from './runtime/proxy/index.js';
+export * from './runtime/engine.js';
+export * from './adapters/auth/index.js';
+export * from './adapters/rest/index.js';
+export * from './adapters/mcp/index.js';
+export * from './adapters/events/index.js';
+export { scaffoldProject } from './cli/scaffold.js';
+export { PROJECT_TYPES } from './cli/types/values.js';
+export { version } from './version.js';
+/**
+ * Assemble an engine from a config: load the schema from `schemaDir`
+ * (default `.` — the project root's `objects/` directory), then build the
+ * RBAC-decorated data-access layer and expose the REST/MCP interfaces.
+ *
+ * Load-only by default: WeaveKit bridges your database without touching it —
+ * DDL (CREATE/ALTER) runs only when `migrate.auto` is enabled (greenfield) or
+ * via an explicit `weave migrate`.
+ */
+export async function createEngine(config) {
+    const locale = resolveLocale(config.locale);
+    const dir = config.schemaDir ?? '.';
+    let registry;
+    if (config.migrate?.auto === true) {
+        const sync = await syncSchema({
+            dir,
+            databaseUrl: config.databaseUrl,
+            locale,
+        });
+        registry = sync.registry;
+        if (config.commit?.meta === true) {
+            const changes = await diffMetadata(dir, sync.files, locale);
+            const commit = await autoCommit({
+                dir,
+                message: buildCommitMessage(changes),
+                identity: config.commit?.identity,
+                locale,
+            });
+            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);
+                try {
+                    await recordSchemaChanges(pool, changes, sync.files, {
+                        sha: commit.sha,
+                        author,
+                        applied: sync.migration.applied,
+                    });
+                }
+                finally {
+                    await pool.end();
+                }
+            }
+        }
+    }
+    else {
+        const { registry: loaded } = await loadSchemaDir(dir, { locale, allowedFieldTypes: config.features?.fieldTypes });
+        loaded.buildGraph({ locale });
+        registry = loaded;
+    }
+    return buildEngineFromRegistry(registry, config);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/infrastructure/alerts/console.d.ts

@@ -0,0 +1,4 @@
+import type { AlertSink } from '../../core/provider/alerts/index.js';
+/** console alert sink — writes to console.warn/console.error by severity */
+export declare function createConsoleAlertSink(): AlertSink;
+//# sourceMappingURL=console.d.ts.map

package/dist/infrastructure/alerts/console.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/alerts/console.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,SAAS,EAAE,MAAM,qCAAqC,CAAC;AAEjF,4EAA4E;AAC5E,wBAAgB,sBAAsB,IAAI,SAAS,CAWlD"}

package/dist/infrastructure/alerts/console.js

@@ -0,0 +1,15 @@
+/** console alert sink — writes to console.warn/console.error by severity */
+export function createConsoleAlertSink() {
+    return {
+        async alert(level, message, meta) {
+            const line = meta === undefined ? message : `${message} ${JSON.stringify(meta)}`;
+            if (level === 'error') {
+                console.error(`[weavekit:alert:error] ${line}`);
+            }
+            else {
+                console.warn(`[weavekit:alert:warn] ${line}`);
+            }
+        },
+    };
+}
+//# sourceMappingURL=console.js.map

package/dist/infrastructure/alerts/console.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.js","sourceRoot":"","sources":["../../../src/infrastructure/alerts/console.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,MAAM,UAAU,sBAAsB;IACpC,OAAO;QACL,KAAK,CAAC,KAAK,CAAC,KAAiB,EAAE,OAAe,EAAE,IAA8B;YAC5E,MAAM,IAAI,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YACjF,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;gBACtB,OAAO,CAAC,KAAK,CAAC,0BAA0B,IAAI,EAAE,CAAC,CAAC;YAClD,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/infrastructure/alerts/index.d.ts

@@ -0,0 +1,34 @@
+import type { AlertSink, FetchLike } from '../../core/provider/alerts/index.js';
+export { createConsoleAlertSink } from './console.js';
+export { createSlackAlertSink } from './slack.js';
+export { createWebhookAlertSink } from './webhook.js';
+export type { SlackAlertSinkOptions } from './slack.js';
+export type { WebhookAlertSinkOptions } from './webhook.js';
+export declare const ALERT_CHANNELS: {
+    readonly CONSOLE: "console";
+    readonly WEBHOOK: "webhook";
+    readonly SLACK: "slack";
+};
+export type AlertChannel = typeof ALERT_CHANNELS[keyof typeof ALERT_CHANNELS];
+/** factory config — channel-dependent fields are validated at call time */
+export interface AlertsConfig {
+    /** sink selection; defaults to 'console' */
+    channel?: AlertChannel;
+    /** webhook channel: target URL */
+    url?: string;
+    /** webhook channel: extra headers */
+    headers?: Record<string, string>;
+    /** shared request timeout in ms; defaults to 5000 */
+    timeoutMs?: number;
+    /** shared fetch implementation, injectable for tests */
+    fetch?: FetchLike;
+    /** slack channel: incoming webhook URL */
+    webhookUrl?: string;
+    /** slack channel: optional channel override */
+    slackChannel?: string;
+    /** slack channel: optional sender name */
+    slackUsername?: string;
+}
+/** build an alert sink from config; defaults to the console sink */
+export declare function createAlerts(config?: AlertsConfig): AlertSink;
+//# sourceMappingURL=index.d.ts.map

package/dist/infrastructure/alerts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/alerts/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AAKhF,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACxD,YAAY,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAE5D,eAAO,MAAM,cAAc;;;;CAIjB,CAAC;AACX,MAAM,MAAM,YAAY,GAAG,OAAO,cAAc,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;AAE9E,2EAA2E;AAC3E,MAAM,WAAW,YAAY;IAC3B,4CAA4C;IAC5C,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,kCAAkC;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,oEAAoE;AACpE,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,SAAS,CAkB7D"}

package/dist/infrastructure/alerts/index.js

@@ -0,0 +1,34 @@
+import { createConsoleAlertSink } from './console.js';
+import { createSlackAlertSink } from './slack.js';
+import { createWebhookAlertSink } from './webhook.js';
+export { createConsoleAlertSink } from './console.js';
+export { createSlackAlertSink } from './slack.js';
+export { createWebhookAlertSink } from './webhook.js';
+export const ALERT_CHANNELS = {
+    CONSOLE: 'console',
+    WEBHOOK: 'webhook',
+    SLACK: 'slack',
+};
+/** build an alert sink from config; defaults to the console sink */
+export function createAlerts(config) {
+    const channel = config?.channel ?? ALERT_CHANNELS.CONSOLE;
+    switch (channel) {
+        case ALERT_CHANNELS.WEBHOOK:
+            if (config?.url === undefined)
+                throw new Error('alerts config: webhook channel requires a url');
+            return createWebhookAlertSink({ url: config.url, headers: config.headers, timeoutMs: config.timeoutMs, fetch: config.fetch });
+        case ALERT_CHANNELS.SLACK:
+            if (config?.webhookUrl === undefined)
+                throw new Error('alerts config: slack channel requires a webhookUrl');
+            return createSlackAlertSink({
+                webhookUrl: config.webhookUrl,
+                channel: config.slackChannel,
+                username: config.slackUsername,
+                timeoutMs: config.timeoutMs,
+                fetch: config.fetch,
+            });
+        default:
+            return createConsoleAlertSink();
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/infrastructure/alerts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/infrastructure/alerts/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAEtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAItD,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,OAAO;CACN,CAAC;AAuBX,oEAAoE;AACpE,MAAM,UAAU,YAAY,CAAC,MAAqB;IAChD,MAAM,OAAO,GAAG,MAAM,EAAE,OAAO,IAAI,cAAc,CAAC,OAAO,CAAC;IAC1D,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,cAAc,CAAC,OAAO;YACzB,IAAI,MAAM,EAAE,GAAG,KAAK,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;YAChG,OAAO,sBAAsB,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAChI,KAAK,cAAc,CAAC,KAAK;YACvB,IAAI,MAAM,EAAE,UAAU,KAAK,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;YAC5G,OAAO,oBAAoB,CAAC;gBAC1B,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,OAAO,EAAE,MAAM,CAAC,YAAY;gBAC5B,QAAQ,EAAE,MAAM,CAAC,aAAa;gBAC9B,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;aACpB,CAAC,CAAC;QACL;YACE,OAAO,sBAAsB,EAAE,CAAC;IACpC,CAAC;AACH,CAAC"}

package/dist/infrastructure/alerts/slack.d.ts

@@ -0,0 +1,20 @@
+import type { AlertSink, FetchLike } from '../../core/provider/alerts/index.js';
+export interface SlackAlertSinkOptions {
+    /** Slack incoming webhook URL (built-in fetch, no SDK) */
+    webhookUrl: string;
+    /** optional channel override, e.g. '#ops' */
+    channel?: string;
+    /** optional sender name override */
+    username?: string;
+    /** request timeout in ms; defaults to 5000 */
+    timeoutMs?: number;
+    /** fetch implementation, injectable for tests; defaults to the global fetch */
+    fetch?: FetchLike;
+}
+/**
+ * Slack alert sink — posts the Slack incoming-webhook JSON payload
+ * `{ text, channel?, username? }` via the built-in fetch. Delivery failures
+ * throw; callers catch and continue.
+ */
+export declare function createSlackAlertSink(options: SlackAlertSinkOptions): AlertSink;
+//# sourceMappingURL=slack.d.ts.map

package/dist/infrastructure/alerts/slack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/alerts/slack.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AAGhF,MAAM,WAAW,qBAAqB;IACpC,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,SAAS,CAqB9E"}

package/dist/infrastructure/alerts/slack.js

@@ -0,0 +1,30 @@
+/**
+ * Slack alert sink — posts the Slack incoming-webhook JSON payload
+ * `{ text, channel?, username? }` via the built-in fetch. Delivery failures
+ * throw; callers catch and continue.
+ */
+export function createSlackAlertSink(options) {
+    const doFetch = options.fetch ?? globalThis.fetch;
+    const timeoutMs = options.timeoutMs ?? 5000;
+    return {
+        async alert(level, message, meta) {
+            const summary = meta === undefined ? message : `${message}\n\`\`\`${JSON.stringify(meta, null, 2)}\`\`\``;
+            const text = `[${level.toUpperCase()}] ${summary}`;
+            const payload = { text };
+            if (options.channel !== undefined)
+                payload.channel = options.channel;
+            if (options.username !== undefined)
+                payload.username = options.username;
+            const res = await doFetch(options.webhookUrl, {
+                method: 'POST',
+                headers: { 'content-type': 'application/json' },
+                body: JSON.stringify(payload),
+                signal: AbortSignal.timeout(timeoutMs),
+            });
+            if (!res.ok) {
+                throw new Error(`slack alert failed: ${res.status} ${res.statusText}`);
+            }
+        },
+    };
+}
+//# sourceMappingURL=slack.js.map

package/dist/infrastructure/alerts/slack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack.js","sourceRoot":"","sources":["../../../src/infrastructure/alerts/slack.ts"],"names":[],"mappings":"AAgBA;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAA8B;IACjE,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC;IAClD,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC;IAC5C,OAAO;QACL,KAAK,CAAC,KAAK,CAAC,KAAiB,EAAE,OAAe,EAAE,IAA8B;YAC5E,MAAM,OAAO,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,WAAW,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC;YAC1G,MAAM,IAAI,GAAG,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,OAAO,EAAE,CAAC;YACnD,MAAM,OAAO,GAA4B,EAAE,IAAI,EAAE,CAAC;YAClD,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS;gBAAE,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;YACrE,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS;gBAAE,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;YACxE,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE;gBAC5C,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;gBAC7B,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC;aACvC,CAAC,CAAC;YACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CAAC,uBAAuB,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;YACzE,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/infrastructure/alerts/webhook.d.ts

@@ -0,0 +1,18 @@
+import type { AlertSink, FetchLike } from '../../core/provider/alerts/index.js';
+export interface WebhookAlertSinkOptions {
+    /** target URL receiving a JSON POST per alert */
+    url: string;
+    /** extra headers, e.g. an Authorization token */
+    headers?: Record<string, string>;
+    /** request timeout in ms; defaults to 5000 */
+    timeoutMs?: number;
+    /** fetch implementation, injectable for tests; defaults to the global fetch */
+    fetch?: FetchLike;
+}
+/**
+ * Generic webhook alert sink — POSTs `{ level, message, meta, ts }` as JSON.
+ * Delivery failures (non-2xx, network errors, timeout) throw; callers catch
+ * and keep the business path moving.
+ */
+export declare function createWebhookAlertSink(options: WebhookAlertSinkOptions): AlertSink;
+//# sourceMappingURL=webhook.d.ts.map

package/dist/infrastructure/alerts/webhook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/alerts/webhook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AAGhF,MAAM,WAAW,uBAAuB;IACtC,iDAAiD;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,uBAAuB,GAAG,SAAS,CAiBlF"}

package/dist/infrastructure/alerts/webhook.js

@@ -0,0 +1,24 @@
+/**
+ * Generic webhook alert sink — POSTs `{ level, message, meta, ts }` as JSON.
+ * Delivery failures (non-2xx, network errors, timeout) throw; callers catch
+ * and keep the business path moving.
+ */
+export function createWebhookAlertSink(options) {
+    const doFetch = options.fetch ?? globalThis.fetch;
+    const timeoutMs = options.timeoutMs ?? 5000;
+    const headers = { 'content-type': 'application/json', ...options.headers };
+    return {
+        async alert(level, message, meta) {
+            const res = await doFetch(options.url, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify({ level, message, meta, ts: new Date().toISOString() }),
+                signal: AbortSignal.timeout(timeoutMs),
+            });
+            if (!res.ok) {
+                throw new Error(`webhook alert failed: ${res.status} ${res.statusText}`);
+            }
+        },
+    };
+}
+//# sourceMappingURL=webhook.js.map

package/dist/infrastructure/alerts/webhook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.js","sourceRoot":"","sources":["../../../src/infrastructure/alerts/webhook.ts"],"names":[],"mappings":"AAcA;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAgC;IACrE,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC;IAClD,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC;IAC5C,MAAM,OAAO,GAAG,EAAE,cAAc,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3E,OAAO;QACL,KAAK,CAAC,KAAK,CAAC,KAAiB,EAAE,OAAe,EAAE,IAA8B;YAC5E,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE;gBACrC,MAAM,EAAE,MAAM;gBACd,OAAO;gBACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;gBAC5E,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC;aACvC,CAAC,CAAC;YACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CAAC,yBAAyB,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;YAC3E,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,18 @@
+import { type EventBus, type EventPublisher } from '../../core/provider/event/index.js';
+/** event bus options */
+export interface EventBusOptions {
+    /** retained events for Last-Event-ID replay; defaults to 1000 */
+    maxEvents?: number;
+}
+/**
+ * In-process event bus with a bounded replay ring buffer. `publish` assigns a
+ * monotonically increasing `seq` (the SSE replay anchor) and delivers to all
+ * current listeners synchronously. The ring buffer is in-memory only: after a
+ * process restart `replay` reports `gap` for any non-empty `afterSeq`, which
+ * the SSE adapter turns into a `schema.changed` nudge (client refetches via
+ * REST). A listener throwing never breaks the bus.
+ */
+export declare function createEventBus(options?: EventBusOptions): EventBus;
+/** narrow publisher facade injected into data-access / audit / assembly */
+export declare function publisherOf(bus: EventBus): EventPublisher;
+//# sourceMappingURL=bus.d.ts.map

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

@@ -0,0 +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"}