@forge-cms/runtime 0.0.1

package/dist/hooks.d.ts

@@ -0,0 +1,60 @@
+import type { AccessQuery, CmsUser, CollectionDefinition, HookContext, HookOperation } from '@forge-cms/core';
+type ChangeCtx = Omit<HookContext, 'collection'>;
+/** Runs first on every operation, before access control resolves. */
+export declare function runBeforeOperationHooks(collection: CollectionDefinition, ctx: {
+    operation: HookOperation;
+    user?: CmsUser | null;
+    overrideAccess?: boolean;
+}): Promise<void>;
+/** Runs last on every operation, with whatever is about to be returned. */
+export declare function runAfterOperationHooks(collection: CollectionDefinition, ctx: {
+    operation: HookOperation;
+    user?: CmsUser | null;
+    overrideAccess?: boolean;
+    result: unknown;
+}): Promise<void>;
+/**
+ * Runs before validation, so a hook can normalise or derive a value that then has to pass the
+ * schema. Throwing rejects the write, same as `beforeChange`.
+ */
+export declare function runBeforeValidateHooks(collection: CollectionDefinition, ctx: ChangeCtx): Promise<Record<string, unknown>>;
+export declare function runBeforeChangeHooks(collection: CollectionDefinition, ctx: ChangeCtx): Promise<Record<string, unknown>>;
+export declare function runAfterChangeHooks(collection: CollectionDefinition, ctx: ChangeCtx & {
+    result: Record<string, unknown>;
+    doc?: Record<string, unknown>;
+}): Promise<void>;
+/** Runs once per read operation and may narrow the query before it is issued. */
+export declare function runBeforeReadHooks(collection: CollectionDefinition, ctx: {
+    user?: CmsUser | null;
+    overrideAccess?: boolean;
+    query: AccessQuery;
+}): Promise<AccessQuery>;
+/** Runs per document on the way out. Returns the document to hand to the caller. */
+export declare function runAfterReadHooks(collection: CollectionDefinition, ctx: {
+    user?: CmsUser | null;
+    overrideAccess?: boolean;
+    doc: Record<string, unknown>;
+}): Promise<Record<string, unknown>>;
+export declare function runBeforeDeleteHooks(collection: CollectionDefinition, ctx: {
+    user?: CmsUser | null;
+    overrideAccess?: boolean;
+    id: string;
+    doc: Record<string, unknown>;
+}): Promise<void>;
+export declare function runAfterDeleteHooks(collection: CollectionDefinition, ctx: {
+    user?: CmsUser | null;
+    overrideAccess?: boolean;
+    id: string;
+    doc: Record<string, unknown>;
+}): Promise<void>;
+type FieldHookName = 'beforeValidate' | 'beforeChange' | 'afterRead';
+/** Threads every top-level and nested field's value through its hook chain. */
+export declare function runFieldHooks(collection: CollectionDefinition, name: FieldHookName, ctx: {
+    data: Record<string, unknown>;
+    previousData?: Record<string, unknown>;
+    operation: HookOperation;
+    user?: CmsUser | null;
+    overrideAccess?: boolean;
+}): Promise<Record<string, unknown>>;
+export {};
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

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

package/dist/hooks.js

@@ -0,0 +1,193 @@
+/**
+ * Runs side-effect hooks without letting a failure roll back work that already happened. These run
+ * after the write is committed, so throwing would report failure for an operation that succeeded.
+ */
+async function runSideEffects(hooks, ctx, label, collection) {
+    if (!hooks || hooks.length === 0)
+        return;
+    for (const hook of hooks) {
+        try {
+            await hook(ctx);
+        }
+        catch (err) {
+            console.error(`${label} hook failed for collection '${collection.slug}':`, err);
+        }
+    }
+}
+/** Runs first on every operation, before access control resolves. */
+export async function runBeforeOperationHooks(collection, ctx) {
+    await runSideEffects(collection.hooks?.beforeOperation, { ...ctx, collection }, 'beforeOperation', collection);
+}
+/** Runs last on every operation, with whatever is about to be returned. */
+export async function runAfterOperationHooks(collection, ctx) {
+    await runSideEffects(collection.hooks?.afterOperation, { ...ctx, collection }, 'afterOperation', collection);
+}
+/**
+ * Runs before validation, so a hook can normalise or derive a value that then has to pass the
+ * schema. Throwing rejects the write, same as `beforeChange`.
+ */
+export async function runBeforeValidateHooks(collection, ctx) {
+    const hooks = collection.hooks?.beforeValidate;
+    if (!hooks || hooks.length === 0)
+        return ctx.data;
+    let data = ctx.data;
+    for (const hook of hooks) {
+        data = await hook({ ...ctx, collection, data });
+    }
+    return data;
+}
+export async function runBeforeChangeHooks(collection, ctx) {
+    const hooks = collection.hooks?.beforeChange;
+    if (!hooks || hooks.length === 0)
+        return ctx.data;
+    let data = ctx.data;
+    for (const hook of hooks) {
+        data = await hook({ ...ctx, collection, data });
+    }
+    return data;
+}
+export async function runAfterChangeHooks(collection, ctx) {
+    // `doc` is the spec-021 name, `result` the spec-013 one. Both are passed so hooks written against
+    // either shape keep working.
+    const doc = ctx.doc ?? ctx.result;
+    await runSideEffects(collection.hooks?.afterChange, { ...ctx, collection, doc, result: ctx.result }, 'afterChange', collection);
+}
+/** Runs once per read operation and may narrow the query before it is issued. */
+export async function runBeforeReadHooks(collection, ctx) {
+    const hooks = collection.hooks?.beforeRead;
+    if (!hooks || hooks.length === 0)
+        return ctx.query;
+    let query = ctx.query;
+    for (const hook of hooks) {
+        query = await hook({ ...ctx, collection, operation: 'read', query });
+    }
+    return query;
+}
+/** Runs per document on the way out. Returns the document to hand to the caller. */
+export async function runAfterReadHooks(collection, ctx) {
+    const hooks = collection.hooks?.afterRead;
+    if (!hooks || hooks.length === 0)
+        return ctx.doc;
+    let doc = ctx.doc;
+    for (const hook of hooks) {
+        doc = await hook({ ...ctx, collection, operation: 'read', doc });
+    }
+    return doc;
+}
+export async function runBeforeDeleteHooks(collection, ctx) {
+    const hooks = collection.hooks?.beforeDelete;
+    if (!hooks || hooks.length === 0)
+        return;
+    // Unlike the after* hooks, a throwing beforeDelete aborts the delete — that is the point of having
+    // one (referential-integrity guards, "this document is still in use" checks).
+    for (const hook of hooks) {
+        await hook({ ...ctx, collection, operation: 'delete' });
+    }
+}
+export async function runAfterDeleteHooks(collection, ctx) {
+    await runSideEffects(collection.hooks?.afterDelete, { ...ctx, collection, operation: 'delete' }, 'afterDelete', collection);
+}
+function hooksFor(field, name) {
+    return field.options.hooks?.[name];
+}
+function isPlainRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+async function runFieldHookChain(field, name, ctx) {
+    let value = ctx.value;
+    for (const hook of hooksFor(field, name) ?? []) {
+        value = await hook({
+            value,
+            data: ctx.data,
+            ...(ctx.previousValue !== undefined && { previousValue: ctx.previousValue }),
+            fieldName: ctx.fieldName,
+            collection: ctx.collection,
+            operation: ctx.operation,
+            user: ctx.user ?? null,
+            ...(ctx.overrideAccess !== undefined && { overrideAccess: ctx.overrideAccess })
+        });
+    }
+    return value;
+}
+async function runFieldMapHooks(fields, name, ctx) {
+    let data = { ...ctx.data };
+    for (const [fieldName, field] of Object.entries(fields)) {
+        const path = ctx.pathPrefix ? `${ctx.pathPrefix}.${fieldName}` : fieldName;
+        const hasOwnValue = Object.prototype.hasOwnProperty.call(data, fieldName);
+        const hasHooks = (hooksFor(field, name)?.length ?? 0) > 0;
+        let value = data[fieldName];
+        value = await runFieldHookChain(field, name, {
+            value,
+            data,
+            ...(ctx.previousData !== undefined && { previousValue: ctx.previousData[fieldName] }),
+            fieldName: path,
+            collection: ctx.collection,
+            operation: ctx.operation,
+            ...(ctx.user !== undefined && { user: ctx.user }),
+            ...(ctx.overrideAccess !== undefined && { overrideAccess: ctx.overrideAccess })
+        });
+        let shouldAssign = hasOwnValue || hasHooks;
+        if (field.kind === 'group' && isPlainRecord(value)) {
+            const previousValue = ctx.previousData?.[fieldName];
+            value = await runFieldMapHooks(field.options.fields, name, {
+                data: value,
+                ...(isPlainRecord(previousValue) && { previousData: previousValue }),
+                pathPrefix: path,
+                collection: ctx.collection,
+                operation: ctx.operation,
+                ...(ctx.user !== undefined && { user: ctx.user }),
+                ...(ctx.overrideAccess !== undefined && { overrideAccess: ctx.overrideAccess })
+            });
+            shouldAssign = true;
+        }
+        if (field.kind === 'array' && Array.isArray(value)) {
+            const previousRows = ctx.previousData?.[fieldName];
+            value = await Promise.all(value.map(async (row, index) => {
+                if (!isPlainRecord(row))
+                    return row;
+                const previousRow = Array.isArray(previousRows) ? previousRows[index] : undefined;
+                return runFieldMapHooks(field.options.fields, name, {
+                    data: row,
+                    ...(isPlainRecord(previousRow) && { previousData: previousRow }),
+                    pathPrefix: `${path}.${index}`,
+                    collection: ctx.collection,
+                    operation: ctx.operation,
+                    ...(ctx.user !== undefined && { user: ctx.user }),
+                    ...(ctx.overrideAccess !== undefined && { overrideAccess: ctx.overrideAccess })
+                });
+            }));
+            shouldAssign = true;
+        }
+        if (field.kind === 'blocks' && Array.isArray(value)) {
+            const previousRows = ctx.previousData?.[fieldName];
+            const blocks = new Map(field.options.blocks.map((block) => [block.slug, block]));
+            value = await Promise.all(value.map(async (row, index) => {
+                if (!isPlainRecord(row) || typeof row.blockType !== 'string')
+                    return row;
+                const block = blocks.get(row.blockType);
+                if (!block)
+                    return row;
+                const previousRow = Array.isArray(previousRows) ? previousRows[index] : undefined;
+                return runFieldMapHooks(block.fields, name, {
+                    data: row,
+                    ...(isPlainRecord(previousRow) && { previousData: previousRow }),
+                    pathPrefix: `${path}.${index}`,
+                    collection: ctx.collection,
+                    operation: ctx.operation,
+                    ...(ctx.user !== undefined && { user: ctx.user }),
+                    ...(ctx.overrideAccess !== undefined && { overrideAccess: ctx.overrideAccess })
+                });
+            }));
+            shouldAssign = true;
+        }
+        if (shouldAssign) {
+            data = { ...data, [fieldName]: value };
+        }
+    }
+    return data;
+}
+/** Threads every top-level and nested field's value through its hook chain. */
+export async function runFieldHooks(collection, name, ctx) {
+    return runFieldMapHooks(collection.fields, name, { ...ctx, collection });
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+export type { AdapterSet, ForgeCmsConfig } from './config.js';
+export type { OperationContext } from './context.js';
+export { ForgeCmsRuntime } from './runtime.js';
+export { handleList, handleRead, handleCreate, handleUpdate, handleDelete, handleGlobalRead, handleGlobalUpdate, handleListVersions, handleGetVersion, handleRestoreVersion, handlePreview, type HandlerOptions, type PreviewOptions, DEFAULT_LIMIT, MAX_LIMIT } from './handlers.js';
+export { handleFile, type FileHandlerOptions } from './files.js';
+export { applyFieldDefaults, applyAutoSlugs } from './defaults.js';
+export { find, findByID, count, create, update, deleteDocument, type PaginatedDocs, type BaseOperationArgs, type FindArgs, type FindByIDArgs, type CountArgs, type CreateArgs, type UpdateArgs, type DeleteArgs } from './operations.js';
+export { getGlobal, updateGlobal, type GlobalBaseArgs, type GetGlobalArgs, type UpdateGlobalArgs } from './globals.js';
+export { listVersions, getVersion, restoreVersion, createVersion, versionsEnabled, autosaveEnabled, type ListVersionsArgs, type GetVersionArgs, type RestoreVersionArgs, type CreateVersionArgs } from './versions.js';
+export { resolveLocale, getLocalizedValue, setLocalizedValue, isLocalizedCollection, isLocalizedField, extractLocaleFromRequest, resolveLocalizedDocument, storeLocalizedDocument } from './localization.js';
+export { findRelationFields, findReferencingDocuments, checkDeleteRestrictions, handleCascadeDelete, handleSetNullOnDelete, findOrphanedDocuments } from './relation-integrity.js';
+export { ForgeError, NotFoundError, InvalidInputError, InvalidQueryError, UnknownFieldError, ValidationFailedError, UnauthorizedError, AccessDeniedError, isForgeError, toApiErrorBody, type ForgeErrorCode, type ForgeApiErrorBody } from './errors.js';
+export { populateRecord, populateRecords } from './populate.js';
+export { describeCollection, describeCollections, describeFields, describeGlobal, describeGlobals, type CollectionDescription, type GlobalDescription, type FieldDescription, type BlockDescription } from './describe.js';
+export { resolveAccess, resolveFieldAccess, mergeWhere, documentMatches, type AccessDecision } from './access.js';
+export { runBeforeOperationHooks, runAfterOperationHooks, runBeforeValidateHooks, runBeforeChangeHooks, runAfterChangeHooks, runBeforeReadHooks, runAfterReadHooks, runBeforeDeleteHooks, runAfterDeleteHooks, runFieldHooks } from './hooks.js';
+export { filterReadableFields, assertWritableFields, FieldAccessError } from './field-access.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":"AAAA,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC9D,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EACL,UAAU,EACV,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,EACb,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,aAAa,EACb,SAAS,EACV,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,UAAU,EAAE,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGjE,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGnE,OAAO,EACL,IAAI,EACJ,QAAQ,EACR,KAAK,EACL,MAAM,EACN,MAAM,EACN,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,UAAU,EAChB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,SAAS,EACT,YAAY,EACZ,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACtB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,YAAY,EACZ,UAAU,EACV,cAAc,EACd,aAAa,EACb,eAAe,EACf,eAAe,EACf,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACvB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,EACvB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,uBAAuB,EACvB,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACvB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGhE,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,eAAe,EACf,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACtB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,UAAU,EACV,eAAe,EACf,KAAK,cAAc,EACpB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,26 @@
+export { ForgeCmsRuntime } from './runtime.js';
+export { handleList, handleRead, handleCreate, handleUpdate, handleDelete, handleGlobalRead, handleGlobalUpdate, handleListVersions, handleGetVersion, handleRestoreVersion, handlePreview, DEFAULT_LIMIT, MAX_LIMIT } from './handlers.js';
+// Serving stored files (spec 040)
+export { handleFile } from './files.js';
+// Field defaults and auto-slugs (spec 040)
+export { applyFieldDefaults, applyAutoSlugs } from './defaults.js';
+// Local API (spec 019) — the transport-free way to run CMS operations from server code.
+export { find, findByID, count, create, update, deleteDocument } from './operations.js';
+// Globals — singleton documents (site-wide config: nav, footer, SEO defaults).
+export { getGlobal, updateGlobal } from './globals.js';
+// Versions — document history, diff, restore.
+export { listVersions, getVersion, restoreVersion, createVersion, versionsEnabled, autosaveEnabled } from './versions.js';
+// Localization — i18n fields, locale resolution, fallback chain.
+export { resolveLocale, getLocalizedValue, setLocalizedValue, isLocalizedCollection, isLocalizedField, extractLocaleFromRequest, resolveLocalizedDocument, storeLocalizedDocument } from './localization.js';
+// Relation integrity — cascade, restrict, set-null on delete.
+export { findRelationFields, findReferencingDocuments, checkDeleteRestrictions, handleCascadeDelete, handleSetNullOnDelete, findOrphanedDocuments } from './relation-integrity.js';
+export { ForgeError, NotFoundError, InvalidInputError, InvalidQueryError, UnknownFieldError, ValidationFailedError, UnauthorizedError, AccessDeniedError, isForgeError, toApiErrorBody } from './errors.js';
+export { populateRecord, populateRecords } from './populate.js';
+// Schema metadata for clients (the admin UI builds its form from this).
+export { describeCollection, describeCollections, describeFields, describeGlobal, describeGlobals } from './describe.js';
+// Access control (spec 020)
+export { resolveAccess, resolveFieldAccess, mergeWhere, documentMatches } from './access.js';
+// Hook pipeline (spec 021)
+export { runBeforeOperationHooks, runAfterOperationHooks, runBeforeValidateHooks, runBeforeChangeHooks, runAfterChangeHooks, runBeforeReadHooks, runAfterReadHooks, runBeforeDeleteHooks, runAfterDeleteHooks, runFieldHooks } from './hooks.js';
+export { filterReadableFields, assertWritableFields, FieldAccessError } from './field-access.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":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EACL,UAAU,EACV,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,EAGb,aAAa,EACb,SAAS,EACV,MAAM,eAAe,CAAC;AAEvB,kCAAkC;AAClC,OAAO,EAAE,UAAU,EAA2B,MAAM,YAAY,CAAC;AAEjE,2CAA2C;AAC3C,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEnE,wFAAwF;AACxF,OAAO,EACL,IAAI,EACJ,QAAQ,EACR,KAAK,EACL,MAAM,EACN,MAAM,EACN,cAAc,EASf,MAAM,iBAAiB,CAAC;AAEzB,+EAA+E;AAC/E,OAAO,EACL,SAAS,EACT,YAAY,EAIb,MAAM,cAAc,CAAC;AAEtB,8CAA8C;AAC9C,OAAO,EACL,YAAY,EACZ,UAAU,EACV,cAAc,EACd,aAAa,EACb,eAAe,EACf,eAAe,EAKhB,MAAM,eAAe,CAAC;AAEvB,iEAAiE;AACjE,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,EACvB,MAAM,mBAAmB,CAAC;AAE3B,8DAA8D;AAC9D,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,uBAAuB,EACvB,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,cAAc,EAGf,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhE,wEAAwE;AACxE,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,eAAe,EAKhB,MAAM,eAAe,CAAC;AAEvB,4BAA4B;AAC5B,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,UAAU,EACV,eAAe,EAEhB,MAAM,aAAa,CAAC;AAErB,2BAA2B;AAC3B,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/localization.d.ts

@@ -0,0 +1,52 @@
+import type { CollectionDefinition } from '@forge-cms/core';
+/**
+ * Localization utilities for handling localized fields and locale resolution.
+ *
+ * Localized fields store values as objects with locale codes as keys:
+ * `{ en: "Hello", es: "Hola" }`
+ *
+ * Locale resolution follows a fallback chain:
+ * - Exact match: `es-MX` -> value for `es-MX`
+ * - Language fallback: `es-MX` -> value for `es`
+ * - Default fallback: first locale in collection's locales array
+ */
+/**
+ * Resolves the locale to use for reading a localized field.
+ * Returns the best matching locale from the available locales.
+ */
+export declare function resolveLocale(requestedLocale: string | undefined, availableLocales: string[]): string;
+/**
+ * Gets the value for a specific locale from a localized field value.
+ * Implements fallback chain: exact -> language -> default.
+ */
+export declare function getLocalizedValue(localizedValue: Record<string, unknown> | unknown, locale: string, availableLocales: string[]): unknown;
+/**
+ * Sets a value for a specific locale in a localized field.
+ * Returns the updated localized value object.
+ */
+export declare function setLocalizedValue(currentValue: Record<string, unknown> | unknown, locale: string, newValue: unknown): Record<string, unknown>;
+/**
+ * Checks if a collection has localization enabled.
+ */
+export declare function isLocalizedCollection(collection: CollectionDefinition): boolean;
+/**
+ * Checks if a field is localized.
+ */
+export declare function isLocalizedField(field: {
+    options: {
+        localized?: boolean;
+    };
+}): boolean;
+/**
+ * Extracts the locale from query parameters or headers.
+ */
+export declare function extractLocaleFromRequest(request: Request, collection: CollectionDefinition): string | undefined;
+/**
+ * Processes a document for reading, resolving localized fields to the requested locale.
+ */
+export declare function resolveLocalizedDocument(document: Record<string, unknown>, collection: CollectionDefinition, locale: string | undefined): Record<string, unknown>;
+/**
+ * Processes a document for writing, storing values in the appropriate locale.
+ */
+export declare function storeLocalizedDocument(data: Record<string, unknown>, collection: CollectionDefinition, locale: string | undefined, existing?: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=localization.d.ts.map

package/dist/localization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localization.d.ts","sourceRoot":"","sources":["../src/localization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAE5D;;;;;;;;;;GAUG;AAEH;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,eAAe,EAAE,MAAM,GAAG,SAAS,EACnC,gBAAgB,EAAE,MAAM,EAAE,GACzB,MAAM,CAwBR;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,EACjD,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,MAAM,EAAE,GACzB,OAAO,CAgCT;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,EAC/C,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,OAAO,GAChB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQzB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,oBAAoB,GAAG,OAAO,CAE/E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IAAE,OAAO,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,GAAG,OAAO,CAErF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,oBAAoB,GAC/B,MAAM,GAAG,SAAS,CAkCpB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,UAAU,EAAE,oBAAoB,EAChC,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiBzB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,UAAU,EAAE,oBAAoB,EAChC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkBzB"}

package/dist/localization.js

@@ -0,0 +1,163 @@
+/**
+ * Localization utilities for handling localized fields and locale resolution.
+ *
+ * Localized fields store values as objects with locale codes as keys:
+ * `{ en: "Hello", es: "Hola" }`
+ *
+ * Locale resolution follows a fallback chain:
+ * - Exact match: `es-MX` -> value for `es-MX`
+ * - Language fallback: `es-MX` -> value for `es`
+ * - Default fallback: first locale in collection's locales array
+ */
+/**
+ * Resolves the locale to use for reading a localized field.
+ * Returns the best matching locale from the available locales.
+ */
+export function resolveLocale(requestedLocale, availableLocales) {
+    if (!requestedLocale || availableLocales.length === 0) {
+        return availableLocales[0] ?? 'en';
+    }
+    // Exact match
+    if (availableLocales.includes(requestedLocale)) {
+        return requestedLocale;
+    }
+    // Language fallback (e.g., es-MX -> es)
+    const language = requestedLocale.split('-')[0];
+    if (language && availableLocales.includes(language)) {
+        return language;
+    }
+    // Find any locale with matching language prefix
+    const matchingLocale = availableLocales.find((locale) => locale.startsWith(language + '-'));
+    if (matchingLocale) {
+        return matchingLocale;
+    }
+    // Default to first available locale
+    return availableLocales[0] ?? 'en';
+}
+/**
+ * Gets the value for a specific locale from a localized field value.
+ * Implements fallback chain: exact -> language -> default.
+ */
+export function getLocalizedValue(localizedValue, locale, availableLocales) {
+    if (typeof localizedValue !== 'object' ||
+        localizedValue === null ||
+        Array.isArray(localizedValue)) {
+        return localizedValue;
+    }
+    const valueObj = localizedValue;
+    const resolvedLocale = resolveLocale(locale, availableLocales);
+    // Try exact locale
+    if (valueObj[resolvedLocale] !== undefined) {
+        return valueObj[resolvedLocale];
+    }
+    // Try language fallback
+    const language = resolvedLocale.split('-')[0];
+    if (language && valueObj[language] !== undefined) {
+        return valueObj[language];
+    }
+    // Try default locale (first in array)
+    const defaultLocale = availableLocales[0];
+    if (defaultLocale && valueObj[defaultLocale] !== undefined) {
+        return valueObj[defaultLocale];
+    }
+    // Return first available value
+    const firstKey = Object.keys(valueObj)[0];
+    return firstKey ? valueObj[firstKey] : undefined;
+}
+/**
+ * Sets a value for a specific locale in a localized field.
+ * Returns the updated localized value object.
+ */
+export function setLocalizedValue(currentValue, locale, newValue) {
+    const existing = typeof currentValue === 'object' && currentValue !== null && !Array.isArray(currentValue)
+        ? { ...currentValue }
+        : {};
+    existing[locale] = newValue;
+    return existing;
+}
+/**
+ * Checks if a collection has localization enabled.
+ */
+export function isLocalizedCollection(collection) {
+    return collection.locales !== undefined && collection.locales.length > 0;
+}
+/**
+ * Checks if a field is localized.
+ */
+export function isLocalizedField(field) {
+    return field.options.localized === true;
+}
+/**
+ * Extracts the locale from query parameters or headers.
+ */
+export function extractLocaleFromRequest(request, collection) {
+    // Try query parameter first
+    const url = new URL(request.url);
+    const queryLocale = url.searchParams.get('locale');
+    if (queryLocale && collection.locales?.includes(queryLocale)) {
+        return queryLocale;
+    }
+    // Try Accept-Language header
+    const acceptLanguage = request.headers.get('accept-language');
+    if (acceptLanguage && collection.locales) {
+        // Parse Accept-Language header (e.g., "en-US,en;q=0.9,es;q=0.8")
+        const languages = acceptLanguage.split(',').map((lang) => {
+            const [code, q] = lang.trim().split(';q=');
+            return { code: code?.trim(), quality: q ? parseFloat(q) : 1.0 };
+        });
+        // Sort by quality descending
+        languages.sort((a, b) => b.quality - a.quality);
+        // Find first matching locale
+        for (const { code } of languages) {
+            if (code && collection.locales.includes(code)) {
+                return code;
+            }
+            // Try language fallback
+            const language = code?.split('-')[0];
+            if (language && collection.locales.includes(language)) {
+                return language;
+            }
+        }
+    }
+    return undefined;
+}
+/**
+ * Processes a document for reading, resolving localized fields to the requested locale.
+ */
+export function resolveLocalizedDocument(document, collection, locale) {
+    if (!isLocalizedCollection(collection) || !locale) {
+        return document;
+    }
+    const resolved = {};
+    for (const [fieldName, value] of Object.entries(document)) {
+        const field = collection.fields[fieldName];
+        if (field && isLocalizedField(field)) {
+            resolved[fieldName] = getLocalizedValue(value, locale, collection.locales);
+        }
+        else {
+            resolved[fieldName] = value;
+        }
+    }
+    return resolved;
+}
+/**
+ * Processes a document for writing, storing values in the appropriate locale.
+ */
+export function storeLocalizedDocument(data, collection, locale, existing) {
+    if (!isLocalizedCollection(collection) || !locale) {
+        return data;
+    }
+    const stored = {};
+    for (const [fieldName, value] of Object.entries(data)) {
+        const field = collection.fields[fieldName];
+        if (field && isLocalizedField(field)) {
+            const existingValue = existing?.[fieldName];
+            stored[fieldName] = setLocalizedValue(existingValue, locale, value);
+        }
+        else {
+            stored[fieldName] = value;
+        }
+    }
+    return stored;
+}
+//# sourceMappingURL=localization.js.map

package/dist/localization.js.map

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

package/dist/operations.d.ts

@@ -0,0 +1,70 @@
+import type { CmsUser, DraftStatus } from '@forge-cms/core';
+import type { DatabaseRecord, DatabaseWhere } from '@forge-cms/db';
+import type { OperationContext } from './context.js';
+import { populateRecord, populateRecords } from './populate.js';
+/** A page of documents plus everything a paginator needs. */
+export interface PaginatedDocs<TDoc = DatabaseRecord> {
+    docs: TDoc[];
+    /** Total documents matching the query, ignoring limit/offset. */
+    totalDocs: number;
+    limit: number | undefined;
+    offset: number;
+    /** 1-based page number derived from limit/offset; always 1 when unpaginated. */
+    page: number;
+    totalPages: number;
+    hasNextPage: boolean;
+    hasPrevPage: boolean;
+}
+export interface BaseOperationArgs {
+    collection: string;
+    /**
+     * The user the operation runs as. `null`/omitted means anonymous.
+     */
+    user?: CmsUser | null;
+    /**
+     * Skip collection- and field-level access checks. Defaults to **true**: a direct Local API call
+     * comes from trusted server code that has already decided it is allowed to do this. The HTTP layer
+     * always passes `false` so requests from the network are checked.
+     */
+    overrideAccess?: boolean;
+    /** `1` replaces relation ids with the related document. Only one level is supported. */
+    depth?: 0 | 1;
+    /** Locale for reading/writing localized fields. */
+    locale?: string;
+}
+export interface FindArgs extends BaseOperationArgs {
+    where?: DatabaseWhere;
+    limit?: number;
+    offset?: number;
+    sort?: string;
+    order?: 'asc' | 'desc';
+    /** Only meaningful on a `drafts: true` collection. Defaults to `published`. */
+    status?: DraftStatus | 'all';
+}
+export interface FindByIDArgs extends BaseOperationArgs {
+    id: string;
+}
+export interface CountArgs extends BaseOperationArgs {
+    where?: DatabaseWhere;
+    status?: DraftStatus | 'all';
+}
+export interface CreateArgs extends BaseOperationArgs {
+    data: Record<string, unknown>;
+}
+export interface UpdateArgs extends BaseOperationArgs {
+    id: string;
+    data: Record<string, unknown>;
+}
+export interface DeleteArgs extends BaseOperationArgs {
+    id: string;
+}
+export declare function find(ctx: OperationContext, args: FindArgs): Promise<PaginatedDocs>;
+export declare function findByID(ctx: OperationContext, args: FindByIDArgs & {
+    status?: DraftStatus | 'all';
+}): Promise<DatabaseRecord>;
+export declare function count(ctx: OperationContext, args: CountArgs): Promise<number>;
+export declare function create(ctx: OperationContext, args: CreateArgs): Promise<DatabaseRecord>;
+export declare function update(ctx: OperationContext, args: UpdateArgs): Promise<DatabaseRecord>;
+export declare function deleteDocument(ctx: OperationContext, args: DeleteArgs): Promise<DatabaseRecord>;
+export { populateRecord, populateRecords };
+//# sourceMappingURL=operations.d.ts.map

package/dist/operations.d.ts.map

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