@weave-kit/engine 0.4.0 → 0.6.0

package/dist/core/object/system-objects.js

@@ -0,0 +1,72 @@
+import { IDENTITY_OBJECT_NAMES } from '../types/values.js';
+import { validateObject } from './validate.js';
+/**
+ * Engine built-in identity objects.
+ *
+ * These are engine-managed (never declared in a project's `objects/` tree) and
+ * live under the reserved `weavekit_` name prefix. They carry the identity used
+ * by ownership (`created_by` / `owner_id`) and department-scoped permissions.
+ * The `user`/`department` field types target these objects implicitly. Their
+ * primary keys are application-generated UUIDs.
+ */
+/** reserved names of the built-in identity objects */
+export const SYSTEM_OBJECT_NAMES = [IDENTITY_OBJECT_NAMES.USER, IDENTITY_OBJECT_NAMES.DEPARTMENT];
+const USER = {
+    name: IDENTITY_OBJECT_NAMES.USER,
+    labels: { en: 'User', zh: '用户' },
+    // engine-owned table: additive ALTER is allowed (the zero-DDL rule protects
+    // only customer tables), so the identity columns below can land on existing DBs
+    alter: true,
+    constraints: [{ type: 'unique', fields: ['external_source', 'external_id'] }],
+    fields: [
+        { name: 'id', type: 'uuid', primary: true, required: true },
+        { name: 'external_source', type: 'string' },
+        { name: 'external_id', type: 'string' },
+        { name: 'roles', type: 'jsonb' },
+        { name: 'name', type: 'string' },
+        { name: 'mobile', type: 'string' },
+        { name: 'email', type: 'string' },
+        { name: 'gender', type: 'string' },
+        { name: 'avatar', type: 'string' },
+        { name: 'employee_number', type: 'string' },
+        { name: 'title', type: 'string' },
+        { name: 'position', type: 'string' },
+        { name: 'employee_rank', type: 'string' },
+        { name: 'entry_date', type: 'date' },
+        { name: 'departure_date', type: 'date' },
+        { name: 'birthday', type: 'date' },
+        { name: 'department_id', type: 'relation', target: IDENTITY_OBJECT_NAMES.DEPARTMENT },
+        { name: 'director_id', type: 'relation', target: IDENTITY_OBJECT_NAMES.USER },
+        { name: 'enabled', type: 'boolean' },
+        { name: 'sort_key', type: 'string' },
+        { name: 'description', type: 'text' },
+    ],
+};
+const DEPARTMENT = {
+    name: IDENTITY_OBJECT_NAMES.DEPARTMENT,
+    labels: { en: 'Department', zh: '部门' },
+    alter: true,
+    constraints: [{ type: 'unique', fields: ['external_source', 'external_id'] }],
+    fields: [
+        { name: 'id', type: 'uuid', primary: true, required: true },
+        { name: 'external_source', type: 'string' },
+        { name: 'external_id', type: 'string' },
+        { name: 'name', type: 'string' },
+        { name: 'code', type: 'string' },
+        { name: 'parent_id', type: 'relation', target: IDENTITY_OBJECT_NAMES.DEPARTMENT },
+        { name: 'manager_id', type: 'relation', target: IDENTITY_OBJECT_NAMES.USER },
+        { name: 'enabled', type: 'boolean' },
+        { name: 'sort_key', type: 'string' },
+        { name: 'description', type: 'text' },
+    ],
+};
+let cache;
+/** the validated built-in identity objects (lazily validated, cached) */
+export function systemObjects() {
+    cache ??= [
+        validateObject(USER, { allowReservedName: true }),
+        validateObject(DEPARTMENT, { allowReservedName: true }),
+    ];
+    return cache;
+}
+//# sourceMappingURL=system-objects.js.map

package/dist/core/object/system-objects.js.map

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

package/dist/core/object/validate/constraints.d.ts

@@ -0,0 +1,9 @@
+import type { FieldDefinition, ObjectDefinition } from '../../types/index.js';
+import { type Vc } from './primitives.js';
+/**
+ * Validate the optional object-level `constraints` array: each entry must be a
+ * supported kind with a non-empty, duplicate-free `fields` list of existing
+ * non-`details` field names; the same field set may not be constrained twice.
+ */
+export declare function validateConstraints(raw: unknown, vc: Vc, fields: readonly FieldDefinition[]): ObjectDefinition['constraints'] | undefined;
+//# sourceMappingURL=constraints.d.ts.map

package/dist/core/object/validate/constraints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constraints.d.ts","sourceRoot":"","sources":["../../../../src/core/object/validate/constraints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,eAAe,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE9F,OAAO,EAAkB,KAAK,EAAE,EAAE,MAAM,iBAAiB,CAAC;AAI1D;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,OAAO,EACZ,EAAE,EAAE,EAAE,EACN,MAAM,EAAE,SAAS,eAAe,EAAE,GACjC,gBAAgB,CAAC,aAAa,CAAC,GAAG,SAAS,CA4B7C"}

package/dist/core/object/validate/constraints.js

@@ -0,0 +1,45 @@
+import { CONSTRAINT_TYPES, FIELD_TYPES } from '../../types/values.js';
+import { fail, isRecord } from './primitives.js';
+const CONSTRAINT_TYPE_VALUES = Object.values(CONSTRAINT_TYPES);
+/**
+ * Validate the optional object-level `constraints` array: each entry must be a
+ * supported kind with a non-empty, duplicate-free `fields` list of existing
+ * non-`details` field names; the same field set may not be constrained twice.
+ */
+export function validateConstraints(raw, vc, fields) {
+    if (raw === undefined)
+        return undefined;
+    if (!Array.isArray(raw))
+        fail(vc, 'object.constraints.notArray');
+    const byName = new Map(fields.map((f) => [f.name, f]));
+    const seen = new Set();
+    return raw.map((entry, i) => {
+        if (!isRecord(entry))
+            fail(vc, 'object.constraints.notObject', { i });
+        const type = entry.type;
+        if (typeof type !== 'string' || !CONSTRAINT_TYPE_VALUES.includes(type)) {
+            fail(vc, 'object.constraints.type.invalid', { i, types: CONSTRAINT_TYPE_VALUES.join('/') });
+        }
+        const list = entry.fields;
+        if (!Array.isArray(list) || list.length === 0 || !list.every((f) => typeof f === 'string')) {
+            fail(vc, 'object.constraints.fields.required', { i });
+        }
+        const within = new Set();
+        for (const f of list) {
+            const field = byName.get(f);
+            if (field === undefined)
+                fail(vc, 'object.constraints.fields.unknown', { i, field: f });
+            if (field.type === FIELD_TYPES.DETAILS)
+                fail(vc, 'object.constraints.fields.details', { i, field: f });
+            if (within.has(f))
+                fail(vc, 'object.constraints.fields.duplicate', { i, field: f });
+            within.add(f);
+        }
+        const signature = [...list].sort().join('\u0000');
+        if (seen.has(signature))
+            fail(vc, 'object.constraints.duplicate', { i });
+        seen.add(signature);
+        return { type: type, fields: list };
+    });
+}
+//# sourceMappingURL=constraints.js.map

package/dist/core/object/validate/constraints.js.map

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

package/dist/core/object/validate/field.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"field.d.ts","sourceRoot":"","sources":["../../../../src/core/object/validate/field.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAoB,eAAe,EAA6B,MAAM,sBAAsB,CAAC;AACzG,OAAO,EAKL,KAAK,iBAAiB,EACvB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAaL,KAAK,EAAE,EACR,MAAM,iBAAiB,CAAC;AAuGzB,0EAA0E;AAC1E,MAAM,WAAW,oBAAoB;IACnC,qFAAqF;IACrF,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,yEAAyE;IACzE,UAAU,CAAC,EAAE,iBAAiB,CAAC;CAChC;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,OAAO,GAAE,oBAAyB,GAAG,eAAe,CAwTvG"}
+{"version":3,"file":"field.d.ts","sourceRoot":"","sources":["../../../../src/core/object/validate/field.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAoB,eAAe,EAA6B,MAAM,sBAAsB,CAAC;AACzG,OAAO,EAOL,KAAK,iBAAiB,EACvB,MAAM,sBAAsB,CAAC;AAK9B,OAAO,EAaL,KAAK,EAAE,EACR,MAAM,iBAAiB,CAAC;AAyIzB,0EAA0E;AAC1E,MAAM,WAAW,oBAAoB;IACnC,qFAAqF;IACrF,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,yEAAyE;IACzE,UAAU,CAAC,EAAE,iBAAiB,CAAC;CAChC;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,OAAO,GAAE,oBAAyB,GAAG,eAAe,CAsevG"}