@byline/core 0.9.3

package/dist/config/validate-collections.js

@@ -0,0 +1,70 @@
+/**
+ * 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
+ */
+/**
+ * Field names that cannot be declared in a collection schema because they
+ * collide with system-managed attributes on `documentVersions`. Exported
+ * so storage-layer reconstruction can skip orphan rows that may exist in
+ * store tables from installations whose schemas declared these names as
+ * user fields before they were promoted to system attributes.
+ */
+export const RESERVED_FIELD_NAMES = new Set(['path']);
+const USE_AS_PATH_SOURCE_TYPES = new Set([
+    'text',
+    'textArea',
+    'select',
+    'date',
+    'datetime',
+    'time',
+]);
+function walkFields(fields, visit) {
+    for (const field of fields) {
+        visit(field);
+        if (field.type === 'group' || field.type === 'array') {
+            walkFields(field.fields, visit);
+        }
+        else if (field.type === 'blocks') {
+            for (const block of field.blocks) {
+                walkFields(block.fields, visit);
+            }
+        }
+    }
+}
+/**
+ * Validate every collection in a configuration.
+ *
+ * Enforced rules:
+ *  - No field (at any nesting depth) may be named `path`. The `path`
+ *    column on `documentVersions` is system-managed; collections opt
+ *    into derived paths via `useAsPath`.
+ *  - When `useAsPath` is set, the referenced field must exist at the
+ *    top level of the collection and be of a type the slugifier can
+ *    sensibly consume (text-like or date-like).
+ *
+ * Throws a plain `Error` (not a `BylineError`) because configuration
+ * validation runs at startup, before the logger and error registry are
+ * necessarily wired up.
+ */
+export function validateCollections(collections) {
+    for (const collection of collections) {
+        walkFields(collection.fields, (field) => {
+            if ('name' in field && RESERVED_FIELD_NAMES.has(field.name)) {
+                throw new Error(`Collection "${collection.path}" declares a field named "${field.name}", which is a reserved system attribute. Use \`useAsPath: '<sourceField>'\` on the collection definition instead.`);
+            }
+        });
+        if (collection.useAsPath != null) {
+            const source = collection.fields.find((f) => 'name' in f && f.name === collection.useAsPath);
+            if (source == null) {
+                throw new Error(`Collection "${collection.path}" sets \`useAsPath: '${collection.useAsPath}'\` but no top-level field with that name exists.`);
+            }
+            if (!USE_AS_PATH_SOURCE_TYPES.has(source.type)) {
+                throw new Error(`Collection "${collection.path}" sets \`useAsPath: '${collection.useAsPath}'\` but field "${collection.useAsPath}" has type "${source.type}". Supported source types: ${[...USE_AS_PATH_SOURCE_TYPES].join(', ')}.`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=validate-collections.js.map

package/dist/config/validate-collections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-collections.js","sourceRoot":"","sources":["../../src/config/validate-collections.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAwB,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAA;AAE1E,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAAY;IAClD,MAAM;IACN,UAAU;IACV,QAAQ;IACR,MAAM;IACN,UAAU;IACV,MAAM;CACP,CAAC,CAAA;AAEF,SAAS,UAAU,CAAC,MAAwB,EAAE,KAA6B;IACzE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,KAAK,CAAC,KAAK,CAAC,CAAA;QACZ,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACrD,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QACjC,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACnC,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;gBACjC,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;YACjC,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAA4C;IAC9E,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,UAAU,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YACtC,IAAI,MAAM,IAAI,KAAK,IAAI,oBAAoB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC5D,MAAM,IAAI,KAAK,CACb,eAAe,UAAU,CAAC,IAAI,6BAA6B,KAAK,CAAC,IAAI,mHAAmH,CACzL,CAAA;YACH,CAAC;QACH,CAAC,CAAC,CAAA;QAEF,IAAI,UAAU,CAAC,SAAS,IAAI,IAAI,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,CACnC,CAAC,CAAC,EAAyC,EAAE,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,SAAS,CAC7F,CAAA;YACD,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;gBACnB,MAAM,IAAI,KAAK,CACb,eAAe,UAAU,CAAC,IAAI,wBAAwB,UAAU,CAAC,SAAS,mDAAmD,CAC9H,CAAA;YACH,CAAC;YACD,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC/C,MAAM,IAAI,KAAK,CACb,eAAe,UAAU,CAAC,IAAI,wBAAwB,UAAU,CAAC,SAAS,kBAAkB,UAAU,CAAC,SAAS,eAAe,MAAM,CAAC,IAAI,8BAA8B,CAAC,GAAG,wBAAwB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACpN,CAAA;YACH,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/config/validate-collections.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=validate-collections.test.node.d.ts.map

package/dist/config/validate-collections.test.node.d.ts.map

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

package/dist/config/validate-collections.test.node.js

@@ -0,0 +1,149 @@
+/**
+ * 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 { describe, expect, it } from 'vitest';
+import { validateCollections } from './validate-collections.js';
+const baseCollection = {
+    path: 'pages',
+    labels: { singular: 'Page', plural: 'Pages' },
+    fields: [{ name: 'title', label: 'Title', type: 'text' }],
+};
+describe('validateCollections', () => {
+    it('accepts a collection with no reserved names and no useAsPath', () => {
+        expect(() => validateCollections([baseCollection])).not.toThrow();
+    });
+    it('rejects a top-level field named "path"', () => {
+        const collection = {
+            ...baseCollection,
+            fields: [
+                { name: 'title', label: 'Title', type: 'text' },
+                { name: 'path', label: 'Path', type: 'text' },
+            ],
+        };
+        expect(() => validateCollections([collection])).toThrow(/reserved system attribute/);
+    });
+    it('rejects a nested "path" field inside a group', () => {
+        const collection = {
+            ...baseCollection,
+            fields: [
+                {
+                    name: 'meta',
+                    label: 'Meta',
+                    type: 'group',
+                    fields: [{ name: 'path', label: 'Path', type: 'text' }],
+                },
+            ],
+        };
+        expect(() => validateCollections([collection])).toThrow(/reserved system attribute/);
+    });
+    it('rejects a "path" field nested inside a block', () => {
+        const collection = {
+            ...baseCollection,
+            fields: [
+                {
+                    name: 'content',
+                    label: 'Content',
+                    type: 'blocks',
+                    blocks: [
+                        {
+                            blockType: 'photoBlock',
+                            fields: [{ name: 'path', label: 'Path', type: 'text' }],
+                        },
+                    ],
+                },
+            ],
+        };
+        expect(() => validateCollections([collection])).toThrow(/reserved system attribute/);
+    });
+    it('accepts a valid useAsPath pointing at a text field', () => {
+        expect(() => validateCollections([{ ...baseCollection, useAsPath: 'title' }])).not.toThrow();
+    });
+    it('rejects a useAsPath pointing at a missing field', () => {
+        expect(() => validateCollections([{ ...baseCollection, useAsPath: 'nonexistent' }])).toThrow(/no top-level field with that name/);
+    });
+    it('rejects a useAsPath pointing at an unsupported field type', () => {
+        const collection = {
+            ...baseCollection,
+            fields: [
+                { name: 'title', label: 'Title', type: 'text' },
+                { name: 'photo', label: 'Photo', type: 'image' },
+            ],
+            useAsPath: 'photo',
+        };
+        expect(() => validateCollections([collection])).toThrow(/Supported source types/);
+    });
+    it('accepts useAsPath pointing at a datetime field', () => {
+        const collection = {
+            ...baseCollection,
+            fields: [
+                { name: 'title', label: 'Title', type: 'text' },
+                { name: 'publishedOn', label: 'Published On', type: 'datetime', mode: 'datetime' },
+            ],
+            useAsPath: 'publishedOn',
+        };
+        expect(() => validateCollections([collection])).not.toThrow();
+    });
+    // useAsPath deliberately resolves against top-level fields only. A
+    // nested source (inside a group, array, or block) isn't addressable
+    // in the derivation cascade — path is a singular identity anchor, not
+    // a per-item or per-locale derivation — so the validator rejects it
+    // at startup rather than silently falling through to a UUID.
+    it('rejects useAsPath pointing at a field nested inside a group', () => {
+        const collection = {
+            ...baseCollection,
+            fields: [
+                { name: 'title', label: 'Title', type: 'text' },
+                {
+                    name: 'meta',
+                    label: 'Meta',
+                    type: 'group',
+                    fields: [{ name: 'slugSource', label: 'Slug source', type: 'text' }],
+                },
+            ],
+            useAsPath: 'slugSource',
+        };
+        expect(() => validateCollections([collection])).toThrow(/no top-level field with that name/);
+    });
+    it('rejects useAsPath pointing at a field nested inside an array', () => {
+        const collection = {
+            ...baseCollection,
+            fields: [
+                { name: 'title', label: 'Title', type: 'text' },
+                {
+                    name: 'variants',
+                    label: 'Variants',
+                    type: 'array',
+                    fields: [{ name: 'slugSource', label: 'Slug source', type: 'text' }],
+                },
+            ],
+            useAsPath: 'slugSource',
+        };
+        expect(() => validateCollections([collection])).toThrow(/no top-level field with that name/);
+    });
+    it('rejects useAsPath pointing at a field nested inside a block', () => {
+        const collection = {
+            ...baseCollection,
+            fields: [
+                { name: 'title', label: 'Title', type: 'text' },
+                {
+                    name: 'content',
+                    label: 'Content',
+                    type: 'blocks',
+                    blocks: [
+                        {
+                            blockType: 'hero',
+                            fields: [{ name: 'slugSource', label: 'Slug source', type: 'text' }],
+                        },
+                    ],
+                },
+            ],
+            useAsPath: 'slugSource',
+        };
+        expect(() => validateCollections([collection])).toThrow(/no top-level field with that name/);
+    });
+});
+//# sourceMappingURL=validate-collections.test.node.js.map

package/dist/config/validate-collections.test.node.js.map

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

package/dist/core.d.ts

@@ -0,0 +1,89 @@
+/**
+ * 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 AbilityDescriptor, AbilityRegistry, type SessionProvider } from '@byline/auth';
+import { type Logger as PinoLogger } from 'pino';
+import { type BylineLogger } from './lib/logger.js';
+import { type CollectionRecord } from './services/collection-bootstrap.js';
+import type { CollectionDefinition, IDbAdapter, IStorageProvider, ServerConfig } from './@types/index.js';
+export interface BylineCore<TAdminStore = unknown> {
+    config: ServerConfig<TAdminStore>;
+    collections: CollectionDefinition[];
+    db: IDbAdapter;
+    storage: IStorageProvider | undefined;
+    logger: BylineLogger;
+    /**
+     * Registered collections, keyed by `path`, with their current DB row id,
+     * schema version, and fingerprint. Populated by `ensureCollections()` at
+     * startup. Prefer `getCollectionRecord(path)` for lookups.
+     */
+    collectionRecords: Map<string, CollectionRecord>;
+    /**
+     * Throwing lookup for a collection's registration record. Use this
+     * wherever you need `(collectionId, collectionVersion)` — callers that
+     * hit this accessor do not need a DB round-trip.
+     */
+    getCollectionRecord: (path: string) => CollectionRecord;
+    /**
+     * Ability registry. Populated at init time with the CRUD + workflow
+     * abilities contributed by each declared collection
+     * (`collections.<path>.{read,create,update,delete,publish,changeStatus}`).
+     *
+     * Plugins and future subsystems contribute their own abilities via
+     * `registerAbility()` — or directly against `core.abilities` — typically
+     * during server bootstrap and before any admin UI renders.
+     *
+     * Consumed at runtime by `AdminAuth.assertAbility()` (Phase 4) and at
+     * design time by the admin role-editor UI (Phase 6). See
+     * docs/analysis/AUTHN-AUTHZ-ANALYSIS.md §3.
+     */
+    abilities: AbilityRegistry;
+    /** Convenience wrapper around `abilities.register()`. */
+    registerAbility: (descriptor: AbilityDescriptor) => void;
+    /** Convenience wrapper around `abilities.list()`. */
+    listAbilities: () => AbilityDescriptor[];
+    /** Convenience wrapper around `abilities.byGroup()`. */
+    getAbilitiesByGroup: () => Map<string, AbilityDescriptor[]>;
+    /**
+     * Configured session provider. Phase 3 leaves this optional — the admin
+     * server-fn middleware wired in Phase 5 will tighten the contract where
+     * authentication is required.
+     */
+    sessionProvider: SessionProvider | undefined;
+    /**
+     * Adapter-built admin store bundle (users / roles / permissions /
+     * refresh tokens). Passed through from `ServerConfig.adminStore` so
+     * consumers (server fns, seeds, admin commands) have a single
+     * adapter-agnostic handle instead of reconstructing the store or
+     * casting `db` to the concrete adapter type.
+     *
+     * Undefined when the installation does not configure admin.
+     */
+    adminStore: TAdminStore | undefined;
+}
+/**
+ * Initialize Byline CMS core services via the typed registry.
+ *
+ * This is the recommended server-side entry point. It composes the
+ * dependency graph and populates the global config singleton for
+ * backward compatibility with `getServerConfig()`.
+ *
+ * @param config - Server configuration (collections, db, storage, i18n).
+ * @param pinoLogger - Optional raw Pino instance. Defaults to `pino({ level: 'info' })`.
+ */
+export declare const initBylineCore: <TAdminStore = unknown>(config: ServerConfig<TAdminStore>, pinoLogger?: PinoLogger) => Promise<BylineCore<TAdminStore>>;
+/**
+ * Typed accessor for the composed `BylineCore` registered by
+ * `initBylineCore`. Throws if init has not run yet.
+ *
+ * The generic `TAdminStore` parameter mirrors `BylineCore<TAdminStore>` —
+ * callers that consume `core.adminStore` should pass the concrete admin
+ * store type (e.g. `getBylineCore<AdminStore>()`); callers that don't
+ * touch `adminStore` can omit it.
+ */
+export declare function getBylineCore<TAdminStore = unknown>(): BylineCore<TAdminStore>;
+//# sourceMappingURL=core.d.ts.map

package/dist/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,iBAAiB,EAAE,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAA;AAC5F,OAAO,EAAE,KAAK,MAAM,IAAI,UAAU,EAAQ,MAAM,MAAM,CAAA;AAItD,OAAO,EAAE,KAAK,YAAY,EAAoC,MAAM,iBAAiB,CAAA;AAErF,OAAO,EAAE,KAAK,gBAAgB,EAAqB,MAAM,oCAAoC,CAAA;AAE7F,OAAO,KAAK,EACV,oBAAoB,EACpB,UAAU,EACV,gBAAgB,EAChB,YAAY,EACb,MAAM,mBAAmB,CAAA;AAE1B,MAAM,WAAW,UAAU,CAAC,WAAW,GAAG,OAAO;IAC/C,MAAM,EAAE,YAAY,CAAC,WAAW,CAAC,CAAA;IACjC,WAAW,EAAE,oBAAoB,EAAE,CAAA;IACnC,EAAE,EAAE,UAAU,CAAA;IACd,OAAO,EAAE,gBAAgB,GAAG,SAAS,CAAA;IACrC,MAAM,EAAE,YAAY,CAAA;IACpB;;;;OAIG;IACH,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;IAChD;;;;OAIG;IACH,mBAAmB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,gBAAgB,CAAA;IACvD;;;;;;;;;;;;OAYG;IACH,SAAS,EAAE,eAAe,CAAA;IAC1B,yDAAyD;IACzD,eAAe,EAAE,CAAC,UAAU,EAAE,iBAAiB,KAAK,IAAI,CAAA;IACxD,qDAAqD;IACrD,aAAa,EAAE,MAAM,iBAAiB,EAAE,CAAA;IACxC,wDAAwD;IACxD,mBAAmB,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAA;IAC3D;;;;OAIG;IACH,eAAe,EAAE,eAAe,GAAG,SAAS,CAAA;IAC5C;;;;;;;;OAQG;IACH,UAAU,EAAE,WAAW,GAAG,SAAS,CAAA;CACpC;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,GAAU,WAAW,GAAG,OAAO,EACxD,QAAQ,YAAY,CAAC,WAAW,CAAC,EACjC,aAAY,UAAoC,KAC/C,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAuEjC,CAAA;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,WAAW,GAAG,OAAO,KAAK,UAAU,CAAC,WAAW,CAAC,CAE9E"}

package/dist/core.js

@@ -0,0 +1,99 @@
+/**
+ * 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 { AbilityRegistry } from '@byline/auth';
+import { pino } from 'pino';
+import { registerCollectionAbilities } from './auth/register-collection-abilities.js';
+import { defineBylineCore, defineServerConfig, getBylineCoreUnsafe } from './config/config.js';
+import { createBylineLogger, defineLogger } from './lib/logger.js';
+import { Registry } from './lib/registry.js';
+import { ensureCollections } from './services/collection-bootstrap.js';
+import { validateRichTextFieldFlags } from './services/richtext-populate.js';
+/**
+ * Initialize Byline CMS core services via the typed registry.
+ *
+ * This is the recommended server-side entry point. It composes the
+ * dependency graph and populates the global config singleton for
+ * backward compatibility with `getServerConfig()`.
+ *
+ * @param config - Server configuration (collections, db, storage, i18n).
+ * @param pinoLogger - Optional raw Pino instance. Defaults to `pino({ level: 'info' })`.
+ */
+export const initBylineCore = async (config, pinoLogger = pino({ level: 'info' })) => {
+    const registry = new Registry()
+        .addValue('config', config)
+        .addValue('collections', config.collections)
+        .addValue('db', config.db)
+        .addValue('storage', config.storage)
+        .addFactory('logger', createBylineLogger);
+    const composed = registry.compose({ pinoLogger });
+    // Validate richText field flags against the registered server adapter
+    // before any DB work. Fail-fast surfaces unrenderable configurations
+    // (both flags off) and missing-adapter cases at boot rather than at
+    // request time.
+    validateRichTextFieldFlags(composed.collections, config.fields?.richText?.populate != null);
+    // Backward compat: populate globalThis singletons
+    defineServerConfig(config);
+    defineLogger(composed.logger);
+    // Reconcile collection definitions with the database: insert new rows,
+    // bump schema versions when the fingerprint has drifted, and build the
+    // in-memory record cache used by the lifecycle/upload/client paths.
+    const collectionRecords = await ensureCollections({
+        definitions: composed.collections,
+        db: composed.db,
+        logger: composed.logger,
+    });
+    const getCollectionRecord = (path) => {
+        const record = collectionRecords.get(path);
+        if (!record) {
+            throw new Error(`BylineCore.getCollectionRecord: no record for collection '${path}'. ` +
+                `Known paths: ${Array.from(collectionRecords.keys()).join(', ') || '(none)'}`);
+        }
+        return record;
+    };
+    // Ability registry — populated with each collection's CRUD + workflow
+    // abilities. Plugins and subsystems add their own via
+    // `core.registerAbility()` or `core.abilities.register()`.
+    const abilities = new AbilityRegistry();
+    for (const definition of composed.collections) {
+        registerCollectionAbilities(abilities, definition);
+    }
+    const core = {
+        config: composed.config,
+        collections: composed.collections,
+        db: composed.db,
+        storage: composed.storage,
+        logger: composed.logger,
+        collectionRecords,
+        getCollectionRecord,
+        abilities,
+        registerAbility: (descriptor) => abilities.register(descriptor),
+        listAbilities: () => abilities.list(),
+        getAbilitiesByGroup: () => abilities.byGroup(),
+        sessionProvider: composed.config.sessionProvider,
+        adminStore: composed.config.adminStore,
+    };
+    // Register on the global singleton so server-side packages
+    // (`@byline/host-tanstack-start/server-fns/*`, future hosts) can read
+    // post-init state via `getBylineCore()` instead of importing the
+    // host's server config module directly.
+    defineBylineCore(core);
+    return core;
+};
+/**
+ * Typed accessor for the composed `BylineCore` registered by
+ * `initBylineCore`. Throws if init has not run yet.
+ *
+ * The generic `TAdminStore` parameter mirrors `BylineCore<TAdminStore>` —
+ * callers that consume `core.adminStore` should pass the concrete admin
+ * store type (e.g. `getBylineCore<AdminStore>()`); callers that don't
+ * touch `adminStore` can omit it.
+ */
+export function getBylineCore() {
+    return getBylineCoreUnsafe();
+}
+//# sourceMappingURL=core.js.map

package/dist/core.js.map

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

package/dist/defaults/default-values.d.ts

@@ -0,0 +1,13 @@
+import type { DefaultValue, DefaultValueContext, FieldSet } from '../@types/field-types.js';
+export declare function resolveDefaultValue<T>(defaultValue: DefaultValue<T> | undefined, ctx?: Partial<DefaultValueContext>): Promise<T | undefined>;
+export declare function resolveFieldDefaultValue(field: {
+    defaultValue?: DefaultValue;
+} & Record<string, any>, ctx?: Partial<DefaultValueContext>): Promise<unknown | undefined>;
+/**
+ * Build initial document data from a field list.
+ *
+ * This is intentionally conservative: it only sets values that are explicitly defaulted
+ * (either via `defaultValue` or via nested structure fields that have child defaults).
+ */
+export declare function buildInitialDataFromFields(fields: FieldSet, ctx?: Partial<DefaultValueContext>): Promise<Record<string, any>>;
+//# sourceMappingURL=default-values.d.ts.map

package/dist/defaults/default-values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-values.d.ts","sourceRoot":"","sources":["../../src/defaults/default-values.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAW3F,wBAAsB,mBAAmB,CAAC,CAAC,EACzC,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,EACzC,GAAG,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GACjC,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAYxB;AAED,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE;IAAE,YAAY,CAAC,EAAE,YAAY,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5D,GAAG,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GACjC,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAE9B;AAED;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,QAAQ,EAChB,GAAG,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GACjC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAoC9B"}

package/dist/defaults/default-values.js

@@ -0,0 +1,60 @@
+import { isStructureField } from '../@types/field-types.js';
+function normalizeCtx(ctx) {
+    return {
+        data: ctx?.data ?? {},
+        locale: ctx?.locale,
+        now: ctx?.now ?? (() => new Date()),
+        uuid: ctx?.uuid,
+    };
+}
+export async function resolveDefaultValue(defaultValue, ctx) {
+    if (defaultValue === undefined) {
+        return undefined;
+    }
+    const normalized = normalizeCtx(ctx);
+    if (typeof defaultValue === 'function') {
+        return defaultValue(normalized);
+    }
+    return defaultValue;
+}
+export async function resolveFieldDefaultValue(field, ctx) {
+    return resolveDefaultValue(field.defaultValue, ctx);
+}
+/**
+ * Build initial document data from a field list.
+ *
+ * This is intentionally conservative: it only sets values that are explicitly defaulted
+ * (either via `defaultValue` or via nested structure fields that have child defaults).
+ */
+export async function buildInitialDataFromFields(fields, ctx) {
+    const normalized = normalizeCtx(ctx);
+    const out = {};
+    for (const field of fields) {
+        const currentData = { ...normalized.data, ...out };
+        const explicit = await resolveFieldDefaultValue(field, {
+            ...normalized,
+            data: currentData,
+        });
+        if (explicit !== undefined) {
+            out[field.name] = explicit;
+            continue;
+        }
+        if (!isStructureField(field)) {
+            continue;
+        }
+        // If this is a structure field with child defaults, build a nested default.
+        // For arrays we avoid guessing a default shape.
+        if (field.type === 'group') {
+            // Group fields are represented as a plain object keyed by child field names.
+            const nested = await buildInitialDataFromFields(field.fields, {
+                ...normalized,
+                data: currentData,
+            });
+            if (Object.keys(nested).length > 0) {
+                out[field.name] = nested;
+            }
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=default-values.js.map

package/dist/defaults/default-values.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-values.js","sourceRoot":"","sources":["../../src/defaults/default-values.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAG3D,SAAS,YAAY,CAAC,GAAkC;IACtD,OAAO;QACL,IAAI,EAAE,GAAG,EAAE,IAAI,IAAI,EAAE;QACrB,MAAM,EAAE,GAAG,EAAE,MAAM;QACnB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;QACnC,IAAI,EAAE,GAAG,EAAE,IAAI;KAChB,CAAA;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,YAAyC,EACzC,GAAkC;IAElC,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,MAAM,UAAU,GAAG,YAAY,CAAC,GAAG,CAAC,CAAA;IAEpC,IAAI,OAAO,YAAY,KAAK,UAAU,EAAE,CAAC;QACvC,OAAQ,YAA2D,CAAC,UAAU,CAAC,CAAA;IACjF,CAAC;IAED,OAAO,YAAY,CAAA;AACrB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,KAA4D,EAC5D,GAAkC;IAElC,OAAO,mBAAmB,CAAC,KAAK,CAAC,YAAY,EAAE,GAAG,CAAC,CAAA;AACrD,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,MAAgB,EAChB,GAAkC;IAElC,MAAM,UAAU,GAAG,YAAY,CAAC,GAAG,CAAC,CAAA;IACpC,MAAM,GAAG,GAAwB,EAAE,CAAA;IAEnC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,WAAW,GAAG,EAAE,GAAG,UAAU,CAAC,IAAI,EAAE,GAAG,GAAG,EAAE,CAAA;QAElD,MAAM,QAAQ,GAAG,MAAM,wBAAwB,CAAC,KAAK,EAAE;YACrD,GAAG,UAAU;YACb,IAAI,EAAE,WAAW;SAClB,CAAC,CAAA;QAEF,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAA;YAC1B,SAAQ;QACV,CAAC;QAED,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7B,SAAQ;QACV,CAAC;QAED,4EAA4E;QAC5E,gDAAgD;QAChD,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC3B,6EAA6E;YAC7E,MAAM,MAAM,GAAG,MAAM,0BAA0B,CAAC,KAAK,CAAC,MAAM,EAAE;gBAC5D,GAAG,UAAU;gBACb,IAAI,EAAE,WAAW;aAClB,CAAC,CAAA;YACF,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACnC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAA;YAC1B,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+export * from './@types/index.js';
+export { applyBeforeRead, assertActorCanPerform, COLLECTION_ABILITY_VERBS, type CollectionAbilityVerb, collectionAbilityKey, registerCollectionAbilities, } from './auth/index.js';
+export { defineClientConfig, defineServerConfig, getClientConfig, getCollectionAdminConfig, getCollectionDefinition, getServerConfig, } from './config/config.js';
+export { resolveRoutes } from './config/routes.js';
+export { validateAdminConfigs } from './config/validate-admin-configs.js';
+export { RESERVED_FIELD_NAMES } from './config/validate-collections.js';
+export { type BylineCore, getBylineCore, initBylineCore } from './core.js';
+export * from './defaults/default-values.js';
+export { BylineError, ERR_DATABASE, ERR_NOT_FOUND, ERR_READ_BUDGET_EXCEEDED, ERR_STORAGE, ERR_UNHANDLED, ERR_VALIDATION, ErrorCodes, type ErrorReport, } from './lib/errors.js';
+export { type BylineLogger, getLogger } from './lib/logger.js';
+export { AsyncRegistry, type RegisteredServices, Registry } from './lib/registry.js';
+export * from './patches/index.js';
+export { mergePredicates, type ParseContext, type ParsedSort, type ParsedWhere, parseSort, parseWhere, } from './query/parse-where.js';
+export { getCollectionSchemasForPath } from './schemas/zod/cache.js';
+export * from './services/index.js';
+export * from './storage/index.js';
+export { formatTextValue, looksLikeISODate, type SlugifierFn, type SlugifyContext, slugify, } from './utils/slugify.js';
+export { getUploadFields, hasUploadField, isUploadField } from './utils/storage-utils.js';
+export * from './workflow/index.js';
+//# 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":"AAiBA,cAAc,mBAAmB,CAAA;AACjC,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,wBAAwB,EACxB,KAAK,qBAAqB,EAC1B,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,wBAAwB,EACxB,uBAAuB,EACvB,eAAe,GAChB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAA;AACzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAA;AACvE,OAAO,EAAE,KAAK,UAAU,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAC1E,cAAc,8BAA8B,CAAA;AAC5C,OAAO,EACL,WAAW,EACX,YAAY,EACZ,aAAa,EACb,wBAAwB,EACxB,WAAW,EACX,aAAa,EACb,cAAc,EACd,UAAU,EACV,KAAK,WAAW,GACjB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,KAAK,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC9D,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AACpF,cAAc,oBAAoB,CAAA;AAClC,OAAO,EACL,eAAe,EACf,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,SAAS,EACT,UAAU,GACX,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAA;AACpE,cAAc,qBAAqB,CAAA;AACnC,cAAc,oBAAoB,CAAA;AAClC,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,OAAO,GACR,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACzF,cAAc,qBAAqB,CAAA"}

package/dist/index.js

@@ -0,0 +1,36 @@
+// ---------------------------------------------------------------------------
+// @byline/core public surface.
+//
+// Subpath exports (see `package.json`):
+//   - `.`             — main entry (this file); published
+//   - `./zod-schemas`, `./logger`, `./package.json` — published
+//   - `./patches`, `./workflow`, `./services` — NOT published
+//
+// The three unpublished subpaths are in-monorepo boundaries used by
+// the admin server fns and the `@byline/client` SDK. They are
+// registered in the main `exports` map (so workspace consumers and
+// `tsc` can resolve them) but deliberately omitted from
+// `publishConfig.exports` — they are not stable surface and should
+// not be imported by external npm consumers. External access goes
+// through this main entry or `@byline/client`.
+// ---------------------------------------------------------------------------
+export * from './@types/index.js';
+export { applyBeforeRead, assertActorCanPerform, COLLECTION_ABILITY_VERBS, collectionAbilityKey, registerCollectionAbilities, } from './auth/index.js';
+export { defineClientConfig, defineServerConfig, getClientConfig, getCollectionAdminConfig, getCollectionDefinition, getServerConfig, } from './config/config.js';
+export { resolveRoutes } from './config/routes.js';
+export { validateAdminConfigs } from './config/validate-admin-configs.js';
+export { RESERVED_FIELD_NAMES } from './config/validate-collections.js';
+export { getBylineCore, initBylineCore } from './core.js';
+export * from './defaults/default-values.js';
+export { BylineError, ERR_DATABASE, ERR_NOT_FOUND, ERR_READ_BUDGET_EXCEEDED, ERR_STORAGE, ERR_UNHANDLED, ERR_VALIDATION, ErrorCodes, } from './lib/errors.js';
+export { getLogger } from './lib/logger.js';
+export { AsyncRegistry, Registry } from './lib/registry.js';
+export * from './patches/index.js';
+export { mergePredicates, parseSort, parseWhere, } from './query/parse-where.js';
+export { getCollectionSchemasForPath } from './schemas/zod/cache.js';
+export * from './services/index.js';
+export * from './storage/index.js';
+export { formatTextValue, looksLikeISODate, slugify, } from './utils/slugify.js';
+export { getUploadFields, hasUploadField, isUploadField } from './utils/storage-utils.js';
+export * from './workflow/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,+BAA+B;AAC/B,EAAE;AACF,wCAAwC;AACxC,0DAA0D;AAC1D,gEAAgE;AAChE,8DAA8D;AAC9D,EAAE;AACF,oEAAoE;AACpE,8DAA8D;AAC9D,mEAAmE;AACnE,wDAAwD;AACxD,mEAAmE;AACnE,kEAAkE;AAClE,+CAA+C;AAC/C,8EAA8E;AAE9E,cAAc,mBAAmB,CAAA;AACjC,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,wBAAwB,EAExB,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,wBAAwB,EACxB,uBAAuB,EACvB,eAAe,GAChB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAA;AACzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAA;AACvE,OAAO,EAAmB,aAAa,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAC1E,cAAc,8BAA8B,CAAA;AAC5C,OAAO,EACL,WAAW,EACX,YAAY,EACZ,aAAa,EACb,wBAAwB,EACxB,WAAW,EACX,aAAa,EACb,cAAc,EACd,UAAU,GAEX,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAqB,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC9D,OAAO,EAAE,aAAa,EAA2B,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AACpF,cAAc,oBAAoB,CAAA;AAClC,OAAO,EACL,eAAe,EAIf,SAAS,EACT,UAAU,GACX,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAA;AACpE,cAAc,qBAAqB,CAAA;AACnC,cAAc,oBAAoB,CAAA;AAClC,OAAO,EACL,eAAe,EACf,gBAAgB,EAGhB,OAAO,GACR,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACzF,cAAc,qBAAqB,CAAA"}