@byline/core 0.9.3

package/dist/lib/registry.js

@@ -0,0 +1,133 @@
+/**
+ * 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
+ *
+ * Typed dependency injection registry. Ported from the Modulus project
+ * (https://github.com/infonomic/modulus) with permission.
+ *
+ * Provides compile-time validation of dependency graphs via TypeScript
+ * conditional types. Services declare their dependencies via constructor
+ * or factory signatures; the registry validates that all requirements
+ * are satisfied before composition.
+ */
+export class Registry {
+    providers = [];
+    addClass(name, value) {
+        this.providers.push({
+            type: 'class',
+            name,
+            value,
+        });
+        return this;
+    }
+    addFactory(name, value) {
+        this.providers.push({
+            type: 'factory',
+            name,
+            value,
+        });
+        return this;
+    }
+    addValue(name, value) {
+        this.providers.push({
+            type: 'value',
+            name,
+            value,
+        });
+        return this;
+    }
+    addNested(name, nested) {
+        this.providers.push({ type: 'nested', name, value: nested });
+        return this;
+    }
+    compose(requirements) {
+        const result = {};
+        const context = { ...requirements };
+        for (const { type, name, value } of this.providers) {
+            if (type === 'value') {
+                context[name] = result[name] = value;
+            }
+            else if (type === 'class') {
+                context[name] = result[name] = new value(context);
+            }
+            else if (type === 'factory') {
+                context[name] = result[name] = value(context);
+            }
+            else if (type === 'nested') {
+                const nestedResult = value.compose(context);
+                context[name] = result[name] = nestedResult;
+            }
+        }
+        return result;
+    }
+}
+export class AsyncRegistry {
+    providers = [];
+    addClass(name, value) {
+        this.providers.push({
+            type: 'class',
+            name,
+            value,
+        });
+        return this;
+    }
+    addAsyncClass(name, value) {
+        this.providers.push({
+            type: 'async-class',
+            name,
+            value,
+        });
+        return this;
+    }
+    addFactory(name, value) {
+        this.providers.push({
+            type: 'factory',
+            name,
+            value,
+        });
+        return this;
+    }
+    addValue(name, value) {
+        this.providers.push({
+            type: 'value',
+            name,
+            value,
+        });
+        return this;
+    }
+    addNested(name, nested) {
+        this.providers.push({ type: 'nested', name, value: nested });
+        return this;
+    }
+    addNestedAsync(name, nested) {
+        this.providers.push({ type: 'nested', name, value: nested });
+        return this;
+    }
+    async compose(requirements) {
+        const result = {};
+        const context = { ...requirements };
+        for (const { type, name, value } of this.providers) {
+            if (type === 'value') {
+                context[name] = result[name] = await value;
+            }
+            else if (type === 'class') {
+                context[name] = result[name] = new value(context);
+            }
+            else if (type === 'async-class') {
+                context[name] = result[name] = await value.create(context);
+            }
+            else if (type === 'factory') {
+                context[name] = result[name] = await value(context);
+            }
+            else if (type === 'nested') {
+                const nestedResult = await value.compose(context);
+                context[name] = result[name] = nestedResult;
+            }
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/lib/registry.js.map

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

package/dist/logger/index.d.ts

@@ -0,0 +1,3 @@
+export { createBylineLogger, defineLogger, getLogContext, getLogger, withLogContext, } from '../lib/logger.js';
+export type { BylineLogger, LogContext, LogData, LogLevel, LogLevelWithSilent, } from '../lib/logger.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/logger/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/logger/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,SAAS,EACT,cAAc,GACf,MAAM,kBAAkB,CAAA;AACzB,YAAY,EACV,YAAY,EACZ,UAAU,EACV,OAAO,EACP,QAAQ,EACR,kBAAkB,GACnB,MAAM,kBAAkB,CAAA"}

package/dist/logger/index.js

@@ -0,0 +1,3 @@
+// packages/core/src/logger/index.ts
+export { createBylineLogger, defineLogger, getLogContext, getLogger, withLogContext, } from '../lib/logger.js';
+//# sourceMappingURL=index.js.map

package/dist/logger/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/logger/index.ts"],"names":[],"mappings":"AAAA,oCAAoC;AAEpC,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,SAAS,EACT,cAAc,GACf,MAAM,kBAAkB,CAAA"}

package/dist/patches/apply-patches.d.ts

@@ -0,0 +1,21 @@
+import type { CollectionDefinition } from '../@types/collection-types.js';
+import type { Field } from '../@types/field-types.js';
+import type { ApplyPatchesResult, DocumentPatch, PatchPath } from './patch-types.js';
+interface PathSegmentField {
+    kind: 'field';
+    key: string;
+}
+interface PathSegmentIndex {
+    kind: 'index';
+    index: number;
+}
+interface PathSegmentId {
+    kind: 'id';
+    id: string;
+}
+type PathSegment = PathSegmentField | PathSegmentIndex | PathSegmentId;
+export declare function parsePatchPath(path: PatchPath): PathSegment[];
+export declare function resolveFieldForPath(definition: CollectionDefinition | null | undefined, path: PatchPath): Field | null;
+export declare function applyPatches(definition: CollectionDefinition, doc: Record<string, any>, patches: DocumentPatch[]): ApplyPatchesResult;
+export {};
+//# sourceMappingURL=apply-patches.d.ts.map

package/dist/patches/apply-patches.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-patches.d.ts","sourceRoot":"","sources":["../../src/patches/apply-patches.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAA;AACzE,OAAO,KAAK,EAAe,KAAK,EAAE,MAAM,0BAA0B,CAAA;AAClE,OAAO,KAAK,EACV,kBAAkB,EAGlB,aAAa,EAGb,SAAS,EACV,MAAM,kBAAkB,CAAA;AAEzB,UAAU,gBAAgB;IACxB,IAAI,EAAE,OAAO,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,UAAU,gBAAgB;IACxB,IAAI,EAAE,OAAO,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CACd;AAED,UAAU,aAAa;IACrB,IAAI,EAAE,IAAI,CAAA;IACV,EAAE,EAAE,MAAM,CAAA;CACX;AAED,KAAK,WAAW,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,aAAa,CAAA;AAOtE,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,WAAW,EAAE,CAgC7D;AAKD,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,oBAAoB,GAAG,IAAI,GAAG,SAAS,EACnD,IAAI,EAAE,SAAS,GACd,KAAK,GAAG,IAAI,CAkDd;AAmOD,wBAAgB,YAAY,CAC1B,UAAU,EAAE,oBAAoB,EAChC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACxB,OAAO,EAAE,aAAa,EAAE,GACvB,kBAAkB,CAsDpB"}

package/dist/patches/apply-patches.js

@@ -0,0 +1,357 @@
+// Core implementation of the patch engine
+import { isBlocksField, isStructureField } from '../@types/field-types.js';
+// Very small path grammar:
+// - "foo.bar" -> [{field: 'foo'}, {field: 'bar'}]
+// - "reviews[0].rating" -> [{field: 'reviews'}, {index: 0}, {field: 'rating'}]
+// - "reviews[id=abc].rating" -> [{field: 'reviews'}, {id: 'abc'}, {field: 'rating'}]
+// - "content[id=xyz]" -> [{field: 'content'}, {id: 'xyz'}]
+export function parsePatchPath(path) {
+    if (!path)
+        return [];
+    const segments = [];
+    const parts = String(path).split('.');
+    for (const part of parts) {
+        const fieldMatch = part.match(/^([^[]+)/);
+        if (!fieldMatch) {
+            continue;
+        }
+        const field = fieldMatch[1];
+        segments.push({ kind: 'field', key: field });
+        const bracketRegex = /\[([^\]]+)\]/g;
+        let match;
+        // Biome: avoid assignment in the while condition
+        // eslint-disable-next-line no-constant-condition
+        while (true) {
+            match = bracketRegex.exec(part);
+            if (match === null)
+                break;
+            const token = match[1];
+            if (/^\d+$/.test(token)) {
+                segments.push({ kind: 'index', index: Number.parseInt(token, 10) });
+            }
+            else if (token.startsWith('id=')) {
+                segments.push({ kind: 'id', id: token.slice(3) });
+            }
+        }
+    }
+    return segments;
+}
+// Very small, best-effort resolver that walks the CollectionDefinition to find
+// the field targeted by a patch path. This is intentionally conservative and
+// currently only understands top-level fields and simple nested paths.
+export function resolveFieldForPath(definition, path) {
+    if (!definition || !path)
+        return null;
+    const segments = parsePatchPath(path);
+    if (segments.length === 0)
+        return null;
+    const [first, ...rest] = segments;
+    if (!first || first.kind !== 'field')
+        return null;
+    let current = definition.fields.find((f) => f.name === first.key);
+    if (!current)
+        return null;
+    for (const segment of rest) {
+        if (!current)
+            return null;
+        if (segment.kind === 'index') {
+            // Index segments step into array/block children
+            if (isStructureField(current)) {
+                // For array/blocks fields, stay at the container level
+                // so the next field segment can find a child field.
+                continue;
+            }
+            return null;
+        }
+        else if (segment.kind === 'field') {
+            if (isBlocksField(current)) {
+                // BlocksField: search across all blocks' child fields by name.
+                // The segment may match a field in any of the block variants.
+                const blocksField = current;
+                let found;
+                for (const block of blocksField.blocks ?? []) {
+                    found = block.fields.find((f) => f.name === segment.key);
+                    if (found)
+                        break;
+                }
+                current = found;
+            }
+            else if (isStructureField(current) && current.fields) {
+                // Search child fields — handles array and group
+                current = current.fields.find((f) => f.name === segment.key);
+            }
+            else {
+                return null;
+            }
+        }
+        else if (segment.kind === 'id') {
+            // ID-addressed arrays/blocks — stay at current level
+            if (isStructureField(current)) {
+                continue;
+            }
+            return null;
+        }
+    }
+    return current ?? null;
+}
+function getBySegments(root, segments) {
+    let current = root;
+    let parent = null;
+    let key = null;
+    for (const segment of segments) {
+        parent = current;
+        if (parent == null) {
+            break;
+        }
+        if (segment.kind === 'field') {
+            key = segment.key;
+            current = parent[key];
+        }
+        else if (segment.kind === 'index') {
+            if (!Array.isArray(parent)) {
+                throw new Error(`Expected array when resolving index segment in path`);
+            }
+            key = segment.index;
+            current = parent[segment.index];
+        }
+        else if (segment.kind === 'id') {
+            if (!Array.isArray(parent)) {
+                throw new Error(`Expected array when resolving id segment in path`);
+            }
+            const foundIndex = parent.findIndex((item) => item && item._id === segment.id);
+            if (foundIndex === -1) {
+                throw new Error(`Item with id=${segment.id} not found in array`);
+            }
+            key = foundIndex;
+            current = parent[foundIndex];
+        }
+    }
+    return { parent, key };
+}
+function ensurePath(root, segments) {
+    if (segments.length === 0) {
+        return { parent: root, key: null };
+    }
+    let current = root;
+    let parent = null;
+    let key = null;
+    for (let i = 0; i < segments.length; i++) {
+        const segment = segments[i];
+        const next = segments[i + 1];
+        parent = current;
+        if (segment.kind === 'field') {
+            key = segment.key;
+            if (parent == null) {
+                throw new Error('ensurePath encountered null/undefined parent before field segment');
+            }
+            // If this field is followed by an index/id segment, it represents
+            // an array-like field (e.g. "content[0]", "reviews[id=...]"),
+            // so initialise it as [] when missing. Otherwise initialise as {}.
+            const isArrayLikeNext = next && (next.kind === 'index' || next.kind === 'id');
+            if (parent[key] === undefined || parent[key] === null) {
+                parent[key] = isArrayLikeNext ? [] : {};
+            }
+            current = parent[key];
+        }
+        else if (segment.kind === 'index') {
+            if (parent == null) {
+                throw new Error('ensurePath encountered null/undefined parent before index segment');
+            }
+            if (!Array.isArray(parent)) {
+                throw new Error('ensurePath expected array parent for index segment');
+            }
+            key = segment.index;
+            if (parent[key] === undefined || parent[key] === null) {
+                parent[key] = {};
+            }
+            current = parent[key];
+        }
+        else if (segment.kind === 'id') {
+            if (parent == null) {
+                throw new Error('ensurePath encountered null/undefined parent before id segment');
+            }
+            if (!Array.isArray(parent)) {
+                throw new Error('ensurePath expected array parent for id segment');
+            }
+            let idx = parent.findIndex((item) => item && item._id === segment.id);
+            if (idx === -1) {
+                idx = parent.length;
+                parent.push({ _id: segment.id });
+            }
+            key = idx;
+            current = parent[idx];
+        }
+    }
+    return { parent, key };
+}
+function applyFieldPatch(doc, patch) {
+    const segments = parsePatchPath(patch.path);
+    if (segments.length === 0) {
+        throw new Error('Empty path for field patch');
+    }
+    if (patch.kind === 'field.set') {
+        const { parent, key } = ensurePath(doc, segments);
+        if (key === null)
+            throw new Error('Invalid target for field.set');
+        parent[key] = patch.value;
+    }
+    else if (patch.kind === 'field.clear') {
+        const { parent, key } = getBySegments(doc, segments);
+        if (parent && key !== null && Object.hasOwn(parent, key)) {
+            if (Array.isArray(parent) && typeof key === 'number') {
+                parent.splice(key, 1);
+            }
+            else {
+                delete parent[key];
+            }
+        }
+    }
+}
+function resolveArrayAtPath(doc, path) {
+    const segments = parsePatchPath(path);
+    const { parent, key } = ensurePath(doc, segments);
+    if (key === null) {
+        throw new Error('Array path must point to an array field');
+    }
+    if (!Array.isArray(parent[key])) {
+        parent[key] = [];
+    }
+    return parent[key];
+}
+function applyArrayPatch(doc, patch, definition) {
+    const array = resolveArrayAtPath(doc, patch.path);
+    if (patch.kind === 'array.insert') {
+        const index = patch.index ?? array.length;
+        array.splice(index, 0, patch.item);
+    }
+    else if (patch.kind === 'array.move') {
+        const currentIndex = array.findIndex((item) => item && item._id === patch.itemId);
+        // Fallback for arrays without stable ids: treat itemId as an index
+        const index = currentIndex === -1 ? Number.parseInt(patch.itemId, 10) : currentIndex;
+        if (!Number.isFinite(index) || index < 0 || index >= array.length) {
+            throw new Error(`array.move: item with idOrIndex=${patch.itemId} not found`);
+        }
+        const [moved] = array.splice(index, 1);
+        const toIndex = patch.toIndex ?? array.length;
+        array.splice(toIndex, 0, moved);
+    }
+    else if (patch.kind === 'array.remove') {
+        const index = array.findIndex((item) => item && item._id === patch.itemId);
+        if (index === -1) {
+            return;
+        }
+        array.splice(index, 1);
+    }
+    else if (patch.kind === 'array.updateItem') {
+        const index = array.findIndex((item) => item && item._id === patch.itemId);
+        if (index === -1) {
+            throw new Error(`array.updateItem: item with id=${patch.itemId} not found`);
+        }
+        const current = array[index];
+        const { doc: updated, errors } = applyPatches(definition, current, patch.patches);
+        if (errors.length > 0) {
+            throw new Error(`array.updateItem produced nested errors: ${errors.map((e) => e.message).join('; ')}`);
+        }
+        array[index] = updated;
+    }
+}
+function applyBlockPatch(doc, patch, definition) {
+    // Blocks are just arrays of objects with stable ids under the hood.
+    const array = resolveArrayAtPath(doc, patch.path);
+    if (patch.kind === 'block.add') {
+        const _id = crypto.randomUUID();
+        const base = { _id, _type: patch.blockType };
+        if (patch.initialValue && typeof patch.initialValue === 'object') {
+            Object.assign(base, patch.initialValue);
+        }
+        const index = patch.index ?? array.length;
+        array.splice(index, 0, base);
+    }
+    else if (patch.kind === 'block.move') {
+        const index = array.findIndex((item) => item && item._id === patch.blockId);
+        if (index === -1) {
+            throw new Error(`block.move: block with id=${patch.blockId} not found`);
+        }
+        const [item] = array.splice(index, 1);
+        const toIndex = Math.max(0, Math.min(patch.toIndex, array.length));
+        array.splice(toIndex, 0, item);
+    }
+    else if (patch.kind === 'block.remove') {
+        const index = array.findIndex((item) => item && item._id === patch.blockId);
+        if (index === -1) {
+            return;
+        }
+        array.splice(index, 1);
+    }
+    else if (patch.kind === 'block.updateField') {
+        const index = array.findIndex((item) => item && item._id === patch.blockId);
+        if (index === -1) {
+            throw new Error(`block.updateField: block with id=${patch.blockId} not found`);
+        }
+        const block = array[index];
+        const fieldPatch = {
+            kind: 'field.set',
+            path: patch.fieldPath,
+            value: patch.value,
+        };
+        const { doc: updated, errors } = applyPatches(definition, block, [fieldPatch]);
+        if (errors.length > 0) {
+            throw new Error(`block.updateField produced nested errors: ${errors.map((e) => e.message).join('; ')}`);
+        }
+        array[index] = updated;
+    }
+}
+// Main entry point: apply all patches against a cloned document.
+export function applyPatches(definition, doc, patches) {
+    const working = structuredClone(doc);
+    const errors = [];
+    const warnings = [];
+    patches.forEach((patch, index) => {
+        try {
+            // Best-effort schema-aware validation: warn (but don't reject) patches
+            // whose paths do not resolve against the collection definition. This is
+            // intentionally conservative — the resolver only understands a subset of
+            // the path grammar, so a null result does not necessarily mean the path
+            // is invalid.
+            const resolvedField = resolveFieldForPath(definition, patch.path);
+            if (!resolvedField) {
+                warnings.push({
+                    index,
+                    message: `Patch path could not be resolved against schema: ${String(patch.path ?? '')}`,
+                    patch,
+                });
+            }
+            if (patch.kind === 'field.set' || patch.kind === 'field.clear') {
+                applyFieldPatch(working, patch);
+            }
+            else if (patch.kind === 'array.insert' ||
+                patch.kind === 'array.move' ||
+                patch.kind === 'array.remove' ||
+                patch.kind === 'array.updateItem') {
+                applyArrayPatch(working, patch, definition);
+            }
+            else if (patch.kind === 'block.add' ||
+                patch.kind === 'block.move' ||
+                patch.kind === 'block.remove' ||
+                patch.kind === 'block.updateField') {
+                applyBlockPatch(working, patch, definition);
+            }
+            else {
+                errors.push({
+                    index,
+                    message: `Unsupported patch kind: ${patch.kind}`,
+                    patch,
+                });
+            }
+        }
+        catch (err) {
+            errors.push({
+                index,
+                message: err instanceof Error ? err.message : 'Unknown patch error',
+                patch,
+            });
+        }
+    });
+    return { doc: working, errors, warnings };
+}
+//# sourceMappingURL=apply-patches.js.map

package/dist/patches/apply-patches.js.map

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

package/dist/patches/index.d.ts

@@ -0,0 +1,3 @@
+export * from './apply-patches.js';
+export * from './patch-types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/patches/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/patches/index.ts"],"names":[],"mappings":"AAEA,cAAc,oBAAoB,CAAA;AAClC,cAAc,kBAAkB,CAAA"}

package/dist/patches/index.js

@@ -0,0 +1,4 @@
+// packages/byline/src/patches/index.ts
+export * from './apply-patches.js';
+export * from './patch-types.js';
+//# sourceMappingURL=index.js.map

package/dist/patches/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/patches/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AAEvC,cAAc,oBAAoB,CAAA;AAClC,cAAc,kBAAkB,CAAA"}

package/dist/patches/patch-types.d.ts

@@ -0,0 +1,82 @@
+import type { CollectionDefinition } from '../@types/collection-types.js';
+/** Dot-notation path addressing a field within a document. */
+export type PatchPath = string;
+export interface BasePatch {
+    opId?: string;
+    timestamp?: string;
+}
+export interface FieldSetPatch extends BasePatch {
+    kind: 'field.set';
+    path: PatchPath;
+    value: unknown;
+}
+export interface FieldClearPatch extends BasePatch {
+    kind: 'field.clear';
+    path: PatchPath;
+}
+export type FieldPatch = FieldSetPatch | FieldClearPatch;
+export interface ArrayInsertPatch extends BasePatch {
+    kind: 'array.insert';
+    path: PatchPath;
+    index?: number;
+    item: unknown;
+}
+export interface ArrayMovePatch extends BasePatch {
+    kind: 'array.move';
+    path: PatchPath;
+    itemId: string;
+    toIndex: number;
+}
+export interface ArrayRemovePatch extends BasePatch {
+    kind: 'array.remove';
+    path: PatchPath;
+    itemId: string;
+}
+export interface ArrayUpdateItemPatch extends BasePatch {
+    kind: 'array.updateItem';
+    path: PatchPath;
+    itemId: string;
+    patches: DocumentPatch[];
+}
+export type ArrayPatch = ArrayInsertPatch | ArrayMovePatch | ArrayRemovePatch | ArrayUpdateItemPatch;
+export interface BlockAddPatch extends BasePatch {
+    kind: 'block.add';
+    path: PatchPath;
+    index?: number;
+    blockType: string;
+    initialValue?: unknown;
+}
+export interface BlockMovePatch extends BasePatch {
+    kind: 'block.move';
+    path: PatchPath;
+    blockId: string;
+    toIndex: number;
+}
+export interface BlockRemovePatch extends BasePatch {
+    kind: 'block.remove';
+    path: PatchPath;
+    blockId: string;
+}
+export interface BlockUpdateFieldPatch extends BasePatch {
+    kind: 'block.updateField';
+    path: PatchPath;
+    blockId: string;
+    fieldPath: PatchPath;
+    value: unknown;
+}
+export type BlockPatch = BlockAddPatch | BlockMovePatch | BlockRemovePatch | BlockUpdateFieldPatch;
+export type DocumentPatch = FieldPatch | ArrayPatch | BlockPatch;
+export interface PatchError {
+    index: number;
+    message: string;
+    patch: DocumentPatch;
+}
+export interface ApplyPatchesResult {
+    doc: unknown;
+    errors: PatchError[];
+    warnings: PatchError[];
+}
+export interface PatchContext {
+    definition: CollectionDefinition;
+}
+//# sourceMappingURL=patch-types.d.ts.map