@byline/core 0.9.3

package/dist/schemas/zod/builder.js

@@ -0,0 +1,276 @@
+import * as z from 'zod';
+import { REQUIRED_WORKFLOW_STATUSES } from '../../@types/index.js';
+import { getCollectionDefinition } from '../../config/config.js';
+// Helper function to apply custom validation rules
+const applyValidationRules = (schema, rules) => {
+    return rules.reduce((acc, rule) => {
+        switch (rule.type) {
+            case 'email':
+                return acc.describe(rule.message || 'Invalid email address');
+            case 'url':
+                return acc.describe(rule.message || 'Invalid URL');
+            case 'pattern':
+                return acc.regex(new RegExp(rule.value), rule.message);
+            case 'custom':
+                return acc.refine(rule.value, { message: rule.message });
+            default:
+                return acc;
+        }
+    }, schema);
+};
+// Helper function to apply text field validation
+const applyTextValidation = (schema, field) => {
+    let validatedSchema = schema;
+    if (field.validation?.minLength) {
+        validatedSchema = validatedSchema.min(field.validation.minLength);
+    }
+    if (field.validation?.maxLength) {
+        validatedSchema = validatedSchema.max(field.validation.maxLength);
+    }
+    if (field.validation?.pattern) {
+        validatedSchema = validatedSchema.regex(new RegExp(field.validation.pattern));
+    }
+    return validatedSchema;
+};
+// Helper function to apply datetime validation
+const _applyDateTimeValidation = (schema, _field) => {
+    // TODO: Implement specific datetime validation if needed
+    const validatedSchema = schema;
+    return validatedSchema;
+};
+// Convert a single field to a Zod schema.
+// When strict=true (write operations: create/update), field.optional is
+// respected (required fields are actually required).
+// When strict=false (read operations: list/get/history), all fields are
+// nullable+optional regardless — this means adding a required field to an
+// existing collection never breaks reads of older documents that were
+// stored before the field existed.
+export const fieldToZodSchema = (field, strict = true) => {
+    let schema;
+    switch (field.type) {
+        case 'array':
+            schema = z.any().array();
+            break;
+        case 'text': {
+            let textSchema = z.string();
+            textSchema = applyTextValidation(textSchema, field);
+            if (field.validation?.rules) {
+                textSchema = applyValidationRules(textSchema, field.validation.rules);
+            }
+            schema = textSchema;
+            break;
+        }
+        case 'boolean':
+        case 'checkbox':
+            schema = z.boolean();
+            break;
+        case 'select':
+            if (field.options && field.options.length > 0) {
+                const values = field.options.map((opt) => opt.value);
+                schema = z.enum(values);
+            }
+            else {
+                schema = z.string();
+            }
+            break;
+        case 'datetime': {
+            const dateSchema = z.preprocess((val) => (val === '' || val == null ? null : val), z.coerce.date().refine((val) => val.toString() !== 'Invalid Date', {
+                message: 'Invalid date',
+            }));
+            // TODO: Implement specific datetime validation if needed
+            // dateSchema = applyDateTimeValidation(dateTimeSchema, field)
+            schema = dateSchema;
+            break;
+        }
+        case 'richText': {
+            const richTextSchema = z.any();
+            // TODO: Implement rich text validation if needed
+            // if (field.validation?.minLength || field.validation?.maxLength) {
+            //   // Convert to string for validation if needed
+            //   richTextSchema = z.string()
+            //   if (field.validation.minLength) {
+            //     richTextSchema = (richTextSchema as z.ZodString).min(field.validation.minLength)
+            //   }
+            //   if (field.validation.maxLength) {
+            //     richTextSchema = (richTextSchema as z.ZodString).max(field.validation.maxLength)
+            //   }
+            // }
+            schema = richTextSchema;
+            break;
+        }
+        case 'textArea': {
+            let textAreaSchema = z.string();
+            if (field.validation?.minLength) {
+                textAreaSchema = textAreaSchema.min(field.validation.minLength);
+            }
+            if (field.validation?.maxLength) {
+                textAreaSchema = textAreaSchema.max(field.validation.maxLength);
+            }
+            schema = textAreaSchema;
+            break;
+        }
+        case 'integer':
+            schema = z.number().int();
+            break;
+        case 'float':
+        case 'decimal':
+            schema = z.number();
+            break;
+        case 'image':
+        case 'file': {
+            // StoredFileValue — the object written by the upload endpoint and
+            // stored in the typed store_* tables. Use .passthrough() so schema
+            // evolution (new fields) doesn't break existing documents.
+            schema = z
+                .object({
+                fileId: z.string(),
+                filename: z.string(),
+                originalFilename: z.string(),
+                mimeType: z.string(),
+                fileSize: z.string(),
+                storageProvider: z.string(),
+                storagePath: z.string(),
+                storageUrl: z.string().nullable().optional(),
+                fileHash: z.string().nullable().optional(),
+                imageWidth: z.number().nullable().optional(),
+                imageHeight: z.number().nullable().optional(),
+                imageFormat: z.string().nullable().optional(),
+                processingStatus: z.enum(['pending', 'processing', 'complete', 'failed']),
+                thumbnailGenerated: z.boolean().optional(),
+            })
+                .passthrough();
+            break;
+        }
+        case 'blocks':
+            schema = z.any().array();
+            break;
+        case 'group':
+            // Group fields are complex nested structures validated at the
+            // field-renderer level. The shape depends on the group's child fields
+            // (recursive) and is not constrained here.
+            schema = z.any();
+            break;
+        case 'relation':
+            // Relation values are `RelatedDocumentValue` objects:
+            //   { targetDocumentId, targetCollectionId,
+            //     relationshipType?, cascadeDelete? }
+            // Values come from the picker (UUIDs) or from DB reads (also UUIDs),
+            // but tests may use shorter strings — keep the schema shape-strict
+            // without enforcing UUID format so synthetic fixtures still validate.
+            //
+            // Populated responses (depth > 0) skip this schema in the route layer
+            // because the tree then contains nested documents, not bare refs.
+            schema = z
+                .object({
+                targetDocumentId: z.string(),
+                targetCollectionId: z.string(),
+                relationshipType: z.string().optional(),
+                cascadeDelete: z.boolean().optional(),
+            })
+                .nullable();
+            break;
+        default:
+            schema = z.string();
+    }
+    // In strict mode respect field.optional; in lenient mode always allow null/undefined so reads
+    // never fail on schema-evolved documents.
+    return strict && !field.optional ? schema : schema.nullable().optional();
+};
+// Create the base schema that all collections share.
+// When a collection defines a workflow, status is constrained to its status names;
+// otherwise it falls back to the required statuses (draft, published, archived).
+export const createBaseSchema = (collection) => {
+    const statuses = collection?.workflow?.statuses?.map((s) => s.name) ??
+        [...REQUIRED_WORKFLOW_STATUSES];
+    // z.enum requires a non-empty tuple [string, ...string[]]
+    const statusEnum = z.enum([statuses[0], ...statuses.slice(1)]);
+    return z.object({
+        id: z.uuid(),
+        versionId: z.uuid().optional(),
+        path: z.string().optional(),
+        status: statusEnum,
+        hasPublishedVersion: z.boolean().optional(),
+        createdAt: z.iso.datetime(),
+        updatedAt: z.iso.datetime(),
+    });
+};
+// Create field schemas for a collection.
+// strict=true  → required fields are non-nullable (write / validation use)
+// strict=false → all fields are nullable+optional (read / serialisation use)
+export const createFieldsSchema = (fields, strict = true) => {
+    // Use ZodType<any> so the inferred object output is { [x: string]: any }
+    // rather than { [x: string]: unknown } (Zod v4 defaults ZodType to <unknown>).
+    // This keeps the schema assignable through TanStack Start's serialisation boundary.
+    const fieldsSchemaShape = {};
+    for (const field of fields) {
+        fieldsSchemaShape[field.name] = fieldToZodSchema(field, strict);
+    }
+    return z.object(fieldsSchemaShape);
+};
+// Create pagination/list metadata schema
+export const createListMetaSchema = () => z.object({
+    page: z.number().int().positive(),
+    pageSize: z.number().int().positive(),
+    total: z.number().int().nonnegative(),
+    totalPages: z.number().int().nonnegative(),
+    order: z.string().optional(),
+    desc: z.boolean().optional(),
+});
+// Create collection metadata schema
+export const createCollectionMetaSchema = (collection) => z.object({
+    id: z.string(),
+    labels: z.object({
+        singular: z.string(),
+        plural: z.string(),
+    }),
+    path: z.literal(collection.path),
+});
+// Helper function to get collection definition before calling createCollectionSchemas
+export const createCollectionSchemasForPath = (path) => {
+    const collectionDefinition = getCollectionDefinition(path);
+    if (collectionDefinition == null) {
+        throw new Error(`Collection not found for path: ${path}`);
+    }
+    return createCollectionSchemas(collectionDefinition);
+};
+// Main function to create all schemas for a collection
+export const createCollectionSchemas = (collection) => {
+    const baseSchema = createBaseSchema(collection);
+    // Strict (write) — required fields are enforced.
+    const fieldsSchema = createFieldsSchema(collection.fields, true);
+    // Lenient (read) — all fields are nullable+optional so that older
+    // documents missing a newly-added required field never cause a parse
+    // error in list / get / history responses.
+    const fieldsSchemaLenient = createFieldsSchema(collection.fields, false);
+    const fullSchema = z.object({
+        ...baseSchema.shape,
+        fields: fieldsSchema,
+    });
+    const fullSchemaLenient = z.object({
+        ...baseSchema.shape,
+        fields: fieldsSchemaLenient,
+    });
+    return {
+        base: baseSchema,
+        fields: fieldsSchema,
+        full: fullSchema,
+        list: z.object({
+            docs: z.array(fullSchemaLenient),
+            meta: createListMetaSchema(),
+            included: z.object({
+                collection: createCollectionMetaSchema(collection),
+            }),
+        }),
+        history: z.object({
+            docs: z.array(fullSchemaLenient),
+            meta: createListMetaSchema(),
+        }),
+        create: fieldsSchema,
+        get: fullSchemaLenient,
+        update: fieldsSchema.partial(),
+    };
+};
+// Aliases for consistency
+export const createTypedCollectionSchemas = createCollectionSchemas;
+export const createTypedCollectionSchemasForPath = createCollectionSchemasForPath;
+//# sourceMappingURL=builder.js.map

package/dist/schemas/zod/builder.js.map

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

package/dist/schemas/zod/cache.d.ts

@@ -0,0 +1,14 @@
+import { createTypedCollectionSchemas } from './builder.js';
+import type { CollectionDefinition } from '../../@types/index.js';
+type TypedSchemaSet = ReturnType<typeof createTypedCollectionSchemas>;
+export declare const getCollectionSchemasForPath: (path: string) => TypedSchemaSet;
+export declare const getCollectionSchemas: (collection: CollectionDefinition) => TypedSchemaSet;
+export declare const getTypedCollectionSchemasForPath: (path: string) => TypedSchemaSet;
+export declare const getTypedCollectionSchemas: (collection: CollectionDefinition) => TypedSchemaSet;
+export declare const clearSchemaCache: (collectionPath?: string) => void;
+export declare const getCacheStats: () => {
+    size: number;
+    keys: string[];
+};
+export {};
+//# sourceMappingURL=cache.d.ts.map

package/dist/schemas/zod/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/schemas/zod/cache.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAA;AAC3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAEjE,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,4BAA4B,CAAC,CAAA;AAIrE,eAAO,MAAM,2BAA2B,GAAI,MAAM,MAAM,KAAG,cAM1D,CAAA;AAGD,eAAO,MAAM,oBAAoB,GAAI,YAAY,oBAAoB,KAAG,cAQvE,CAAA;AAGD,eAAO,MAAM,gCAAgC,SApBK,MAAM,KAAG,cAoBgB,CAAA;AAC3E,eAAO,MAAM,yBAAyB,eAZW,oBAAoB,KAAG,cAYX,CAAA;AAG7D,eAAO,MAAM,gBAAgB,GAAI,iBAAiB,MAAM,KAAG,IAU1D,CAAA;AAGD,eAAO,MAAM,aAAa;;;CAGxB,CAAA"}

package/dist/schemas/zod/cache.js

@@ -0,0 +1,40 @@
+import { getCollectionDefinition } from '../../config/config.js';
+import { createTypedCollectionSchemas } from './builder.js';
+const schemaCache = new Map();
+export const getCollectionSchemasForPath = (path) => {
+    const collectionDefinition = getCollectionDefinition(path);
+    if (collectionDefinition == null) {
+        throw new Error(`Collection not found for path: ${path}`);
+    }
+    return getCollectionSchemas(collectionDefinition);
+};
+// Get schemas for a collection (with caching)
+export const getCollectionSchemas = (collection) => {
+    const cacheKey = collection.path;
+    if (schemaCache.has(cacheKey) === false) {
+        schemaCache.set(cacheKey, createTypedCollectionSchemas(collection));
+    }
+    return schemaCache.get(cacheKey) || createTypedCollectionSchemas(collection);
+};
+// Aliases for consistency (these are the same as above now)
+export const getTypedCollectionSchemasForPath = getCollectionSchemasForPath;
+export const getTypedCollectionSchemas = getCollectionSchemas;
+// Clear cache for a specific collection or all collections
+export const clearSchemaCache = (collectionPath) => {
+    if (collectionPath) {
+        for (const key of schemaCache.keys()) {
+            if (key === collectionPath) {
+                schemaCache.delete(key);
+            }
+        }
+    }
+    else {
+        schemaCache.clear();
+    }
+};
+// Get cache statistics
+export const getCacheStats = () => ({
+    size: schemaCache.size,
+    keys: Array.from(schemaCache.keys()),
+});
+//# sourceMappingURL=cache.js.map

package/dist/schemas/zod/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../src/schemas/zod/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AAChE,OAAO,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAA;AAK3D,MAAM,WAAW,GAAG,IAAI,GAAG,EAA0B,CAAA;AAErD,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,IAAY,EAAkB,EAAE;IAC1E,MAAM,oBAAoB,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAA;IAC1D,IAAI,oBAAoB,IAAI,IAAI,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,kCAAkC,IAAI,EAAE,CAAC,CAAA;IAC3D,CAAC;IACD,OAAO,oBAAoB,CAAC,oBAAoB,CAAC,CAAA;AACnD,CAAC,CAAA;AAED,8CAA8C;AAC9C,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,UAAgC,EAAkB,EAAE;IACvF,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAA;IAEhC,IAAI,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,KAAK,EAAE,CAAC;QACxC,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,4BAA4B,CAAC,UAAU,CAAC,CAAC,CAAA;IACrE,CAAC;IAED,OAAO,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,4BAA4B,CAAC,UAAU,CAAC,CAAA;AAC9E,CAAC,CAAA;AAED,4DAA4D;AAC5D,MAAM,CAAC,MAAM,gCAAgC,GAAG,2BAA2B,CAAA;AAC3E,MAAM,CAAC,MAAM,yBAAyB,GAAG,oBAAoB,CAAA;AAE7D,2DAA2D;AAC3D,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,cAAuB,EAAQ,EAAE;IAChE,IAAI,cAAc,EAAE,CAAC;QACnB,KAAK,MAAM,GAAG,IAAI,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC;YACrC,IAAI,GAAG,KAAK,cAAc,EAAE,CAAC;gBAC3B,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YACzB,CAAC;QACH,CAAC;IACH,CAAC;SAAM,CAAC;QACN,WAAW,CAAC,KAAK,EAAE,CAAA;IACrB,CAAC;AACH,CAAC,CAAA;AAED,uBAAuB;AACvB,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,EAAE,CAAC,CAAC;IAClC,IAAI,EAAE,WAAW,CAAC,IAAI;IACtB,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;CACrC,CAAC,CAAA"}

package/dist/schemas/zod/index.d.ts

@@ -0,0 +1,4 @@
+export * from './builder.js';
+export * from './cache.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/schemas/zod/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/schemas/zod/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA"}

package/dist/schemas/zod/index.js

@@ -0,0 +1,4 @@
+export * from './builder.js';
+export * from './cache.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/schemas/zod/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/schemas/zod/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA"}

package/dist/schemas/zod/types.d.ts

@@ -0,0 +1,13 @@
+import type { z } from 'zod';
+import type { getCollectionSchemasForPath } from './cache.js';
+export type CollectionSchemaTypes<T extends ReturnType<typeof getCollectionSchemasForPath>> = {
+    BaseType: z.infer<T['base']>;
+    FullType: z.infer<T['full']>;
+    ListType: z.infer<T['list']>;
+    HistoryType: z.infer<T['history']>;
+    CreateType: z.infer<T['create']>;
+    GetType: z.infer<T['get']>;
+    UpdateType: z.infer<T['update']>;
+};
+export type AnyCollectionSchemaTypes = CollectionSchemaTypes<ReturnType<typeof getCollectionSchemasForPath>>;
+//# sourceMappingURL=types.d.ts.map

package/dist/schemas/zod/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/schemas/zod/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAE5B,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAA;AAG7D,MAAM,MAAM,qBAAqB,CAAC,CAAC,SAAS,UAAU,CAAC,OAAO,2BAA2B,CAAC,IAAI;IAC5F,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAA;IAC5B,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAA;IAC5B,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAA;IAC5B,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAA;IAClC,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;IAChC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAA;IAC1B,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;CACjC,CAAA;AAGD,MAAM,MAAM,wBAAwB,GAAG,qBAAqB,CAC1D,UAAU,CAAC,OAAO,2BAA2B,CAAC,CAC/C,CAAA"}

package/dist/schemas/zod/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/schemas/zod/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/schemas/zod/types.ts"],"names":[],"mappings":""}

package/dist/services/collection-bootstrap.d.ts

@@ -0,0 +1,46 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+import type { CollectionDefinition, IDbAdapter } from '../@types/index.js';
+import type { BylineLogger } from '../lib/logger.js';
+/**
+ * Snapshot of a collection's current registration: the DB row id, the
+ * schema version stamped on new `documentVersions` rows, and the fingerprint
+ * that was recorded the last time the bootstrap ran. Cached on the core
+ * instance for the lifetime of the process.
+ */
+export interface CollectionRecord {
+    collectionId: string;
+    version: number;
+    schemaHash: string;
+}
+export interface EnsureCollectionsInput {
+    definitions: CollectionDefinition[];
+    db: IDbAdapter;
+    logger?: BylineLogger;
+}
+/**
+ * Reconcile every registered `CollectionDefinition` with its row in the
+ * `collections` table. Runs once at startup from `initBylineCore()`.
+ *
+ * Behaviour per collection:
+ *   1. Compute the data-shape fingerprint.
+ *   2. If no row exists: insert with `version = definition.version ?? 1`
+ *      and the fingerprint.
+ *   3. If a row exists and the fingerprint matches: no-op.
+ *   4. If a row exists and the fingerprint differs:
+ *        - `definition.version` pinned explicitly and `> stored.version` → use it
+ *        - `definition.version` pinned explicitly and `<= stored.version` → throw
+ *        - otherwise → auto-bump to `stored.version + 1`
+ *      Then write back `{ config, version, schema_hash, updated_at }`.
+ *
+ * Returns a `Map<path, CollectionRecord>` to be cached on the core instance
+ * so downstream callers (lifecycle, upload, client handle) can resolve
+ * `(collectionId, collectionVersion)` without another DB round-trip.
+ */
+export declare function ensureCollections({ definitions, db, logger, }: EnsureCollectionsInput): Promise<Map<string, CollectionRecord>>;
+//# sourceMappingURL=collection-bootstrap.d.ts.map

package/dist/services/collection-bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-bootstrap.d.ts","sourceRoot":"","sources":["../../src/services/collection-bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAEpD;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,oBAAoB,EAAE,CAAA;IACnC,EAAE,EAAE,UAAU,CAAA;IACd,MAAM,CAAC,EAAE,YAAY,CAAA;CACtB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,iBAAiB,CAAC,EACtC,WAAW,EACX,EAAE,EACF,MAAM,GACP,EAAE,sBAAsB,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAcjE"}

package/dist/services/collection-bootstrap.js

@@ -0,0 +1,108 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+import { fingerprintCollection } from '../storage/collection-fingerprint.js';
+/**
+ * Reconcile every registered `CollectionDefinition` with its row in the
+ * `collections` table. Runs once at startup from `initBylineCore()`.
+ *
+ * Behaviour per collection:
+ *   1. Compute the data-shape fingerprint.
+ *   2. If no row exists: insert with `version = definition.version ?? 1`
+ *      and the fingerprint.
+ *   3. If a row exists and the fingerprint matches: no-op.
+ *   4. If a row exists and the fingerprint differs:
+ *        - `definition.version` pinned explicitly and `> stored.version` → use it
+ *        - `definition.version` pinned explicitly and `<= stored.version` → throw
+ *        - otherwise → auto-bump to `stored.version + 1`
+ *      Then write back `{ config, version, schema_hash, updated_at }`.
+ *
+ * Returns a `Map<path, CollectionRecord>` to be cached on the core instance
+ * so downstream callers (lifecycle, upload, client handle) can resolve
+ * `(collectionId, collectionVersion)` without another DB round-trip.
+ */
+export async function ensureCollections({ definitions, db, logger, }) {
+    // Each collection reconciles independently (separate rows, independent
+    // SELECT/UPDATE paths), so we fan out with Promise.all. At 20+ collections
+    // or higher DB latency this turns linear round-trips into one concurrent
+    // batch.
+    const reconciled = await Promise.all(definitions.map((definition) => reconcileCollection(definition, db, logger)));
+    const records = new Map();
+    for (const entry of reconciled) {
+        records.set(entry.path, entry.record);
+    }
+    return records;
+}
+async function reconcileCollection(definition, db, logger) {
+    const fingerprint = await fingerprintCollection(definition);
+    const existing = await db.queries.collections.getCollectionByPath(definition.path);
+    if (existing == null) {
+        const initialVersion = definition.version ?? 1;
+        const inserted = await db.commands.collections.create(definition.path, definition, {
+            version: initialVersion,
+            schemaHash: fingerprint,
+        });
+        const row = Array.isArray(inserted) ? inserted[0] : inserted;
+        const collectionId = row?.id;
+        if (!collectionId) {
+            throw new Error(`ensureCollections: insert for '${definition.path}' did not return a row id`);
+        }
+        logger?.info({ collectionPath: definition.path, version: initialVersion }, 'collection registered');
+        return {
+            path: definition.path,
+            record: { collectionId, version: initialVersion, schemaHash: fingerprint },
+        };
+    }
+    const collectionId = existing.id;
+    const storedVersion = (existing.version ?? 1) | 0;
+    const storedHash = existing.schema_hash ?? null;
+    // Unchanged — stored hash matches. We trust the hash and skip the write
+    // even if `definition.version` was pinned to something higher; the hash
+    // is the source of truth for "did the shape change?".
+    if (storedHash === fingerprint) {
+        return {
+            path: definition.path,
+            record: { collectionId, version: storedVersion, schemaHash: fingerprint },
+        };
+    }
+    // Hash differs (or was never recorded) — decide the next version.
+    let nextVersion;
+    if (definition.version !== undefined) {
+        if (definition.version < storedVersion) {
+            throw new Error(`ensureCollections: collection '${definition.path}' pins version ` +
+                `${definition.version} but the database already records version ${storedVersion}. ` +
+                `Pinning backwards is not allowed.`);
+        }
+        nextVersion = definition.version;
+    }
+    else {
+        // First-run after Phase-1 migration: schema_hash was NULL, so this
+        // looks like a change. Don't bump — just backfill the hash at the
+        // same version the DB already holds.
+        nextVersion = storedHash === null ? storedVersion : storedVersion + 1;
+    }
+    await db.commands.collections.update(collectionId, {
+        config: definition,
+        version: nextVersion,
+        schemaHash: fingerprint,
+    });
+    if (nextVersion !== storedVersion) {
+        logger?.info({
+            collectionPath: definition.path,
+            previousVersion: storedVersion,
+            version: nextVersion,
+        }, 'collection schema version bumped');
+    }
+    else {
+        logger?.debug({ collectionPath: definition.path, version: storedVersion }, 'collection schema hash backfilled');
+    }
+    return {
+        path: definition.path,
+        record: { collectionId, version: nextVersion, schemaHash: fingerprint },
+    };
+}
+//# sourceMappingURL=collection-bootstrap.js.map

package/dist/services/collection-bootstrap.js.map

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

package/dist/services/collection-bootstrap.test.node.d.ts

@@ -0,0 +1,9 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+export {};
+//# sourceMappingURL=collection-bootstrap.test.node.d.ts.map

package/dist/services/collection-bootstrap.test.node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-bootstrap.test.node.d.ts","sourceRoot":"","sources":["../../src/services/collection-bootstrap.test.node.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}