@murumets-ee/entity 0.1.3 → 0.1.5

package/dist/admin/index.d.mts

@@ -0,0 +1,452 @@
+import { SQL } from "drizzle-orm";
+import { PostgresJsDatabase } from "drizzle-orm/postgres-js";
+
+//#region src/count-cache.d.ts
+/**
+ * In-memory TTL cache for COUNT(*) query results.
+ *
+ * Reduces database load on paginated list pages where the total count
+ * is recalculated on every pagination/sort/search interaction. The cache
+ * is per-process (not shared across workers) with a short TTL (default 5s)
+ * so counts are at most a few seconds stale.
+ *
+ * Cache keys include the entity name + serialized WHERE clause, so filtered
+ * and unfiltered counts are cached independently.
+ */
+/**
+ * Interface for count cache implementations.
+ * Used in client configs to avoid TypeScript private-field structural incompatibility
+ * across separate .d.ts files.
+ */
+interface CountCacheLike {
+  get(key: string): number | undefined;
+  set(key: string, count: number): void;
+  invalidate(prefix: string): void;
+}
+//#endregion
+//#region src/cursor.d.ts
+/** Cursor input for keyset pagination. */
+interface CursorInput {
+  /** Sort field name (e.g. 'createdAt'). Must be a real column on the entity. */
+  field: string;
+  /** Last seen value of the sort field. */
+  value: string | number;
+  /** Sort direction — must match the ORDER BY direction. */
+  direction: 'asc' | 'desc';
+  /** Tie-breaker: last seen entity ID. Required for non-unique sort fields. */
+  id?: string;
+}
+//#endregion
+//#region src/admin-config.d.ts
+/**
+ * Optional admin UI configuration for entities.
+ * Controls how entities appear in the admin sidebar, list pages, and forms.
+ */
+interface EntityAdminConfig {
+  /** Sidebar section: 'content' | 'structure' | custom string. Default: 'content' */
+  group?: string;
+  /** Plural display name for sidebar + list pages. Default: title-cased pluralized entity name */
+  label?: string;
+  /** Singular label for "New X" button. Default: title-cased entity name */
+  labelSingular?: string;
+  /** Lucide icon name as string, e.g. 'file-text' */
+  icon?: string;
+  /** Description shown on list page */
+  description?: string;
+  /** Form layout. Default: 'single' */
+  layout?: 'single' | 'two-column';
+  /** Fields to hide in the form */
+  hiddenFields?: string[];
+  /** Columns to hide in the list */
+  hiddenColumns?: string[];
+  /** Per-field label/description/placeholder overrides */
+  fieldOverrides?: Record<string, {
+    label?: string;
+    description?: string;
+    placeholder?: string;
+  }>;
+  /** Default list sort field. Default: 'createdAt' */
+  defaultSort?: string;
+  /** Default list sort direction. Default: 'desc' */
+  defaultSortDirection?: 'asc' | 'desc';
+  /** List page size. Default: 20 */
+  pageSize?: number;
+  /** For block editor: fields to show in Puck root config */
+  rootFields?: string[];
+  /** Suppress "New" button in the list page */
+  disableCreate?: boolean;
+  /** Order within sidebar group. Default: 0 */
+  sortOrder?: number;
+}
+//#endregion
+//#region src/fields/base.d.ts
+/**
+ * Field type definitions
+ * These define the structure and configuration for all field types
+ */
+interface BaseFieldConfig {
+  required?: boolean;
+  default?: unknown;
+  translatable?: boolean;
+  indexed?: boolean;
+  unique?: boolean;
+  access?: {
+    view?: string;
+    edit?: string;
+  };
+}
+interface IdField extends BaseFieldConfig {
+  type: 'id';
+}
+interface TextField extends BaseFieldConfig {
+  type: 'text';
+  maxLength?: number;
+  minLength?: number;
+  pattern?: RegExp;
+}
+interface NumberField extends BaseFieldConfig {
+  type: 'number';
+  min?: number;
+  max?: number;
+  integer?: boolean;
+}
+interface BooleanField extends BaseFieldConfig {
+  type: 'boolean';
+}
+interface DateField extends BaseFieldConfig {
+  type: 'date';
+  minDate?: Date;
+  maxDate?: Date;
+}
+interface SelectField extends BaseFieldConfig {
+  type: 'select';
+  options: readonly string[];
+}
+interface ReferenceField extends BaseFieldConfig {
+  type: 'reference';
+  entity: string;
+  cardinality: 'one' | 'many';
+  onDelete?: 'cascade' | 'set-null' | 'restrict';
+}
+interface MediaField extends BaseFieldConfig {
+  type: 'media';
+  accept?: string[];
+  maxSize?: number;
+}
+interface RichTextField extends BaseFieldConfig {
+  type: 'richtext';
+  blocks?: string[];
+}
+interface SlugField extends BaseFieldConfig {
+  type: 'slug';
+  from: string;
+  unique?: boolean;
+}
+/**
+ * Minimal block definition reference — used by BlocksField to type-check allowed blocks.
+ * The full BlockDefinition (with label, etc.) lives in @murumets-ee/content.
+ */
+interface BlockDefinitionRef {
+  slug: string;
+  fields: Record<string, FieldConfig>;
+}
+/**
+ * Blocks field — ordered array of typed content blocks.
+ * Each block instance stores its data in {entity}_layout table.
+ *
+ * @property blocks - Allowed block definitions
+ * @property min/max - Block count constraints
+ * @property localized - true = per-locale layouts, false = shared layout with translated content (default)
+ */
+interface JsonField extends BaseFieldConfig {
+  type: 'json';
+}
+interface BlocksField extends BaseFieldConfig {
+  type: 'blocks';
+  blocks: readonly BlockDefinitionRef[];
+  min?: number;
+  max?: number;
+  localized?: boolean;
+}
+type FieldConfig = IdField | TextField | NumberField | BooleanField | DateField | SelectField | ReferenceField | MediaField | RichTextField | SlugField | JsonField | BlocksField;
+//#endregion
+//#region src/behaviors/types.d.ts
+interface Behavior<F extends Record<string, FieldConfig> = Record<string, FieldConfig>> {
+  name: string;
+  fields?: F;
+  hooks?: {
+    beforeCreate?: (data: Record<string, unknown>) => Promise<Record<string, unknown>>;
+    afterCreate?: (entity: Record<string, unknown>) => Promise<void>;
+    beforeUpdate?: (id: string, data: Record<string, unknown>) => Promise<Record<string, unknown>>;
+    afterUpdate?: (entity: Record<string, unknown>) => Promise<void>;
+    beforeDelete?: (id: string) => Promise<void>;
+    afterDelete?: (id: string) => Promise<void>;
+  };
+}
+//#endregion
+//#region src/define-entity.d.ts
+/**
+ * A fully resolved entity with merged behavior fields.
+ * @typeParam AllFields - The complete field map (id + behaviors + user fields).
+ */
+interface Entity<AllFields extends Record<string, FieldConfig> = Record<string, FieldConfig>> {
+  name: string;
+  kind?: 'collection' | 'singleton';
+  fields: Record<string, FieldConfig>;
+  behaviors?: Behavior[];
+  scope?: 'global' | 'team' | 'user';
+  access?: {
+    view?: string;
+    create?: string;
+    update?: string;
+    delete?: string;
+  };
+  /** Admin UI configuration — controls sidebar, list, and form display */
+  admin?: EntityAdminConfig;
+  allFields: AllFields;
+  hooks: Behavior['hooks'];
+}
+//#endregion
+//#region src/types/infer.d.ts
+/**
+ * Maps a single FieldConfig to its TypeScript output type.
+ * Each branch is a shallow comparison — no recursion.
+ */
+type FieldToTS<F extends FieldConfig> = F extends IdField ? string : F extends TextField ? string : F extends NumberField ? number : F extends BooleanField ? boolean : F extends DateField ? Date | string : F extends SelectField ? F['options'][number] : F extends ReferenceField ? F['cardinality'] extends 'many' ? string[] : string : F extends MediaField ? string : F extends RichTextField ? Record<string, unknown>[] : F extends SlugField ? string : F extends JsonField ? Record<string, unknown> : F extends BlocksField ? Array<{
+  _block: string;
+  _id: string;
+  [key: string]: unknown;
+}> : never;
+/**
+ * Extract keys of fields where `required` is literally `true`.
+ * Fields without `required` or with `required?: false` are optional.
+ */
+type RequiredFieldKeys<Fields extends Record<string, FieldConfig>> = { [K in keyof Fields]: Fields[K]['required'] extends true ? K : never }[keyof Fields];
+type OptionalFieldKeys<Fields extends Record<string, FieldConfig>> = { [K in keyof Fields]: Fields[K]['required'] extends true ? never : K }[keyof Fields];
+/**
+ * Maps a full field record to its TypeScript output type.
+ * Required fields are non-nullable; optional fields are `T | null | undefined`.
+ *
+ * The `id` field is always `string` and always present.
+ * The `id` key from Fields is excluded to avoid duplication since
+ * we hardcode `{ id: string }` at the front.
+ */
+type InferEntityDTO<Fields extends Record<string, FieldConfig>> = {
+  id: string;
+} & { [K in Exclude<RequiredFieldKeys<Fields>, 'id'>]: FieldToTS<Fields[K]> } & { [K in OptionalFieldKeys<Fields>]?: FieldToTS<Fields[K]> | null };
+/** Fields that are auto-generated and should not appear in create input. */
+type AutoGeneratedFields = 'id' | 'createdAt' | 'updatedAt' | 'createdBy' | 'updatedBy' | '_version';
+/**
+ * The input type for creating an entity.
+ * - Omits auto-generated fields (id, timestamps, version)
+ * - Required fields stay required; optional fields stay optional
+ */
+type InferCreateInput<Fields extends Record<string, FieldConfig>> = Omit<{ [K in Exclude<RequiredFieldKeys<Fields>, 'id'>]: FieldToTS<Fields[K]> } & { [K in OptionalFieldKeys<Fields>]?: FieldToTS<Fields[K]> | null }, AutoGeneratedFields>;
+/** Fields that cannot be changed after creation. */
+type ImmutableFields = 'id' | 'createdAt' | 'createdBy';
+type InferUpdateInput<Fields extends Record<string, FieldConfig>> = Partial<Omit<InferEntityDTO<Fields>, ImmutableFields>>;
+//#endregion
+//#region src/types/logger.d.ts
+/**
+ * Minimal logger interface compatible with Pino.
+ *
+ * Defined locally to avoid a circular build dependency:
+ * entity → logging → core → entity.
+ *
+ * Any Pino logger instance satisfies this interface via structural typing.
+ */
+interface Logger {
+  info(obj: Record<string, unknown>, msg: string): void;
+  debug?(obj: Record<string, unknown>, msg: string): void;
+}
+//#endregion
+//#region src/admin/client.d.ts
+interface AdminClientConfig<AllFields extends Record<string, FieldConfig> = Record<string, FieldConfig>> {
+  entity: Entity<AllFields>;
+  db: PostgresJsDatabase;
+  logger?: Logger;
+  /** Optional count cache for COUNT(*) query optimization. */
+  countCache?: CountCacheLike;
+}
+interface FindManyOptions {
+  where?: SQL | undefined;
+  limit?: number;
+  offset?: number;
+  orderBy?: SQL | SQL[];
+  locale?: string;
+  /** Default content locale. For localized blocks, NULL rows (from initial create)
+   *  are only returned as fallback when locale matches defaultLocale. */
+  defaultLocale?: string;
+  /**
+   * Cursor-based (keyset) pagination. When provided, replaces OFFSET with a
+   * WHERE condition for O(1) page access at any depth. The `offset` option
+   * is ignored when `cursor` is set.
+   *
+   * The cursor `field` must be a real column on the entity table.
+   */
+  cursor?: CursorInput;
+}
+interface CountOptions {
+  where?: SQL | undefined;
+}
+/**
+ * AdminClient - Full CRUD operations with security enforcement
+ *
+ * Security layers:
+ * 1. Runtime check: typeof window !== 'undefined' → throw (allows CLI scripts)
+ * 2. Uses read-write DB connection
+ * 3. Validation with Zod before every write
+ * 4. Hook execution (beforeCreate, afterCreate, etc.)
+ *
+ * Note: We don't use 'server-only' import because it blocks CLI scripts.
+ * Next.js bundler protection comes from subpath exports (@murumets-ee/core/clients).
+ *
+ * Phase 1: Core CRUD + hooks + validation
+ * Phase 2 (TODO): Access control, request context, scoping
+ *
+ * @typeParam AllFields - The entity's complete field map. Inferred automatically
+ *                        when constructing via `createAdminClient(entity)`.
+ */
+declare class AdminClient<AllFields extends Record<string, FieldConfig> = Record<string, FieldConfig>> {
+  private entity;
+  private db;
+  private logger?;
+  private createSchema;
+  private updateSchema;
+  private table;
+  private countCache?;
+  constructor(config: AdminClientConfig<AllFields>);
+  /**
+   * Create a new entity
+   *
+   * Flow:
+   * 1. Validate input with Zod
+   * 2. Execute beforeCreate hooks
+   * 3. Prepare data for insert
+   * 4. Insert into database
+   * 5. Execute afterCreate hooks
+   * 6. Shape DTO and return
+   */
+  create(data: InferCreateInput<AllFields>): Promise<InferEntityDTO<AllFields>>;
+  /**
+   * Find entity by ID
+   */
+  findById(id: string, options?: {
+    locale?: string;
+    defaultLocale?: string;
+  }): Promise<InferEntityDTO<AllFields> | null>;
+  /**
+   * Find multiple entities
+   */
+  findMany(options?: FindManyOptions): Promise<InferEntityDTO<AllFields>[]>;
+  /**
+   * Count entities matching optional conditions
+   */
+  count(options?: CountOptions): Promise<number>;
+  /**
+   * Update entity by ID
+   *
+   * Flow:
+   * 1. Validate input with Zod
+   * 2. Execute beforeUpdate hooks
+   * 3. Prepare data for update
+   * 4. Update in database
+   * 5. Execute afterUpdate hooks
+   * 6. Shape DTO and return
+   */
+  update(id: string, data: InferUpdateInput<AllFields>, options?: {
+    locale?: string;
+  }): Promise<InferEntityDTO<AllFields>>;
+  /**
+   * Delete entity by ID.
+   *
+   * Checks entity_refs for incoming references first — throws
+   * ReferencedEntityError if this entity is still used somewhere.
+   */
+  delete(id: string): Promise<void>;
+  /**
+   * Prepare data for insert — every field is a real column.
+   */
+  private prepareDataForInsert;
+  /**
+   * Prepare data for update — every field is a real column.
+   * Standard column SET, no JSONB merge needed.
+   */
+  private prepareDataForUpdate;
+  /**
+   * Merge translations into entities for the specified locale.
+   * Reads translatable field values from real columns on the translation row.
+   */
+  private mergeTranslations;
+  /**
+   * Save translation for an entity.
+   * Each translatable field is a real column on the translation table.
+   */
+  saveTranslation(entityId: string, locale: string, translations: Record<string, unknown>): Promise<void>;
+  /**
+   * PHASE 3: Delete translation(s) for an entity
+   * If locale is provided, deletes specific locale; otherwise deletes all translations
+   */
+  deleteTranslation(entityId: string, locale?: string): Promise<void>;
+  /**
+   * Save block-level translations for an entity.
+   * For each block in each blocks field, extracts translatable field values
+   * and upserts them into {entity}_layout_translations.
+   *
+   * Block _id must match an existing layout row ID.
+   */
+  saveBlockTranslations(entityId: string, locale: string, data: Record<string, unknown>): Promise<void>;
+  /**
+   * Save per-locale blocks for an entity.
+   * Used for entities with `localized: true` on their blocks field — each locale gets
+   * its own independent block layout rows in the layout table.
+   */
+  saveLocalizedBlocks(entityId: string, locale: string, data: Record<string, unknown>): Promise<void>;
+  /**
+   * Get all blocks field names for this entity.
+   */
+  private getBlocksFields;
+  /**
+   * Save blocks for an entity after create/update.
+   * For each blocks field, writes rows to {entity}_layout table.
+   */
+  private saveBlocks;
+  /**
+   * Load blocks for one or more entities from the layout table.
+   *
+   * Handles both block translation modes:
+   * - Shared layout (localized: false): loads locale=NULL rows, merges translations,
+   *   clears untranslated translatable fields to '' (strict mode for admin editing)
+   * - Per-locale layout (localized: true): loads rows matching the provided locale only
+   *
+   * @param entityIds - Entity IDs to load blocks for
+   * @param locale - Content locale (omit for default locale / base data)
+   * @param options.defaultLocale - Default locale; NULL rows fall back only for this locale
+   */
+  private loadBlocks;
+  /**
+   * Attach loaded blocks to shaped DTOs.
+   */
+  private attachBlocks;
+  /**
+   * Sync outgoing references in entity_refs after create/update.
+   *
+   * - 'create': inserts all refs (entity is new, no existing refs)
+   * - 'update': deletes refs for changed ref-bearing fields, then inserts new ones
+   *
+   * Gracefully skips if entity_refs table is not registered (e.g. before migration).
+   */
+  private syncRefs;
+  /**
+   * Build a cache key for a count query.
+   * Key format: `entityName` for unfiltered, `entityName:where_sql` for filtered.
+   */
+  private buildCountCacheKey;
+  /**
+   * Invalidate all count cache entries for this entity.
+   */
+  private invalidateCountCache;
+}
+//#endregion
+export { AdminClient, type AdminClientConfig, type CountCacheLike, type CountOptions, type FindManyOptions };
+//# sourceMappingURL=index.d.mts.map

package/dist/admin/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/count-cache.ts","../../src/cursor.ts","../../src/admin-config.ts","../../src/fields/base.ts","../../src/behaviors/types.ts","../../src/define-entity.ts","../../src/types/infer.ts","../../src/types/logger.ts","../../src/admin/client.ts"],"mappings":"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"}

package/dist/admin/index.mjs

@@ -0,0 +1,2 @@
+import{schemaRegistry as e}from"@murumets-ee/db";import{and as t,eq as n,gt as r,inArray as i,isNull as a,lt as o,or as s,sql as c}from"drizzle-orm";import{index as l,pgTable as u,unique as d,uuid as f,varchar as p}from"drizzle-orm/pg-core";import{z as m}from"zod";function h(e,i){let a=e[i.field];if(!a)return null;let c=i.direction===`desc`?o:r,l=c(a,i.value);if(!i.id)return l;let u=e.id;if(!u)return l;let d=c(u,i.id);return s(l,t(n(a,i.value),d))}function g(e,t,n){if(!t)return null;let r={},i=n?.select||Object.keys(e.allFields);for(let a of i){if(!n?.includeInternal&&a.startsWith(`_`))continue;let i=e.allFields[a];i&&i.type!==`blocks`&&(r[a]=t[a])}return r}function _(e,t,n){return t.map(t=>g(e,t,n))}var v=class extends Error{entityName;entityId;usages;constructor(e,t,n){let r=n.length;super(`Cannot delete ${e} '${t}': referenced by ${r} other entit${r===1?`y`:`ies`}`),this.name=`ReferencedEntityError`,this.entityName=e,this.entityId=t,this.usages=n}};const y=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;function b(e,t){let n=[],r=new Set;function i(e,t,i){if(!y.test(i))return;let a=`${e}|${t}|${i}`;r.has(a)||(r.add(a),n.push({sourceField:e,targetEntity:t,targetId:i}))}for(let[n,r]of Object.entries(e)){let e=t[n];if(e!=null)switch(r.type){case`media`:typeof e==`string`&&i(n,`media`,e);break;case`reference`:{let t=r;if(t.cardinality===`many`&&Array.isArray(e))for(let r of e)typeof r==`string`&&i(n,t.entity,r);else typeof e==`string`&&i(n,t.entity,e);break}case`blocks`:{let t=r;if(!Array.isArray(e))break;for(let r of e){let e=r,a=e._block;if(!a)continue;let o=t.blocks.find(e=>e.slug===a);if(o)for(let[t,r]of Object.entries(o.fields)){let a=e[t];if(a!=null&&(r.type===`media`&&typeof a==`string`&&i(n,`media`,a),r.type===`reference`)){let e=r;if(e.cardinality===`many`&&Array.isArray(a))for(let t of a)typeof t==`string`&&i(n,e.entity,t);else typeof a==`string`&&i(n,e.entity,a)}}}break}}}return n}const x=u(`entity_refs`,{sourceEntity:p(`source_entity`,{length:100}).notNull(),sourceId:f(`source_id`).notNull(),sourceField:p(`source_field`,{length:100}).notNull(),targetEntity:p(`target_entity`,{length:100}).notNull(),targetId:f(`target_id`).notNull()},e=>[d(`uq_entity_refs`).on(e.sourceEntity,e.sourceId,e.sourceField,e.targetEntity,e.targetId),l(`idx_entity_refs_target`).on(e.targetEntity,e.targetId),l(`idx_entity_refs_source`).on(e.sourceEntity,e.sourceId)]);async function S(e,r,i){return await i.select({sourceEntity:x.sourceEntity,sourceId:x.sourceId,sourceField:x.sourceField}).from(x).where(t(n(x.targetEntity,e),n(x.targetId,r)))}function C(e){let t;switch(e.type){case`id`:t=m.string().uuid();break;case`text`:t=m.string(),e.maxLength&&(t=t.max(e.maxLength)),e.minLength&&(t=t.min(e.minLength)),e.pattern&&(t=t.regex(e.pattern));break;case`number`:t=m.number(),e.integer&&(t=t.int()),e.min!==void 0&&(t=t.min(e.min)),e.max!==void 0&&(t=t.max(e.max));break;case`boolean`:t=m.boolean();break;case`date`:t=m.date().or(m.string().datetime());break;case`select`:t=m.enum(e.options);break;case`reference`:t=e.cardinality===`many`?m.array(m.string().uuid()):m.string().uuid();break;case`media`:t=m.string().uuid();break;case`richtext`:t=m.union([m.string(),m.array(m.record(m.unknown()))]);break;case`slug`:t=m.string().regex(/^[a-z0-9-]+$/);break;case`json`:t=m.record(m.unknown());break;case`blocks`:t=m.array(m.object({_block:m.string()}).passthrough());break;default:t=m.unknown()}return e.required||(t=t.nullable().optional()),e.default!==void 0&&(t=t.default(e.default)),t}function w(e){let t={},n=new Set([`id`,`createdAt`,`updatedAt`,`createdBy`,`_version`]);for(let[r,i]of Object.entries(e.allFields))n.has(r)||(t[r]=C(i));return m.object(t)}function T(e){let t={},n=new Set([`id`,`createdAt`,`createdBy`,`updatedAt`,`updatedBy`,`_version`]);for(let[r,i]of Object.entries(e.allFields))n.has(r)||(t[r]=C(i).optional());return m.object(t)}var E=class{entity;db;logger;createSchema;updateSchema;table;countCache;constructor(t){if(typeof window<`u`)throw Error(`AdminClient cannot be used in browser code. Use QueryClient for frontend data access.`);this.entity=t.entity,this.db=t.db,this.logger=t.logger,this.countCache=t.countCache,this.createSchema=w(t.entity),this.updateSchema=T(t.entity);let n=e.get(t.entity.name);if(!n)throw Error(`Schema for entity '${t.entity.name}' not found in registry. Ensure schemas are generated and registered before creating AdminClient.`);this.table=n}async create(e){this.logger?.info({entity:this.entity.name},`Creating entity`);let t=e;if(this.entity.hooks?.beforeCreate){let e=await this.entity.hooks.beforeCreate(t);t=e===void 0?t:e}t=this.createSchema.parse(t);let n=this.prepareDataForInsert(t),[r]=await this.db.insert(this.table).values(n).returning();await this.saveBlocks(r.id,t),await this.syncRefs(r.id,t,`create`),this.entity.hooks?.afterCreate&&await this.entity.hooks.afterCreate(r),this.invalidateCountCache();let i=g(this.entity,r);if(i&&this.getBlocksFields().length>0){let e=await this.loadBlocks([i.id]);this.attachBlocks([i],e)}return i}async findById(e,t){this.logger?.info({entity:this.entity.name,id:e},`Finding entity by ID`);let[r]=await this.db.select().from(this.table).where(n(this.table.id,e));if(!r)return null;let i=g(this.entity,r);if(!i)return null;if(this.getBlocksFields().length>0){let e=await this.loadBlocks([i.id],t?.locale,{defaultLocale:t?.defaultLocale});this.attachBlocks([i],e)}if(t?.locale){let[e]=await this.mergeTranslations([i],t.locale);return e}return i}async findMany(e){this.logger?.info({entity:this.entity.name,options:e},`Finding entities`);let n=this.db.select().from(this.table).$dynamic(),r=[];if(e?.where&&r.push(e.where),e?.cursor){let t=this.entity.allFields;if(!(e.cursor.field in t)&&e.cursor.field!==`id`)throw Error(`Invalid cursor field: '${e.cursor.field}' is not a field on '${this.entity.name}'`);let n=h(this.table,e.cursor);n&&r.push(n)}if(r.length>0&&(n=n.where(t(...r))),e?.limit&&(n=n.limit(e.limit)),e?.offset&&!e?.cursor&&(n=n.offset(e.offset)),e?.orderBy){let t=Array.isArray(e.orderBy)?e.orderBy:[e.orderBy];n=n.orderBy(...t)}let i=await n,a=_(this.entity,i).filter(e=>e!==null);if(this.getBlocksFields().length>0&&a.length>0){let t=a.map(e=>e.id),n=await this.loadBlocks(t,e?.locale,{defaultLocale:e?.defaultLocale});this.attachBlocks(a,n)}return e?.locale?await this.mergeTranslations(a,e.locale):a}async count(e){this.logger?.info({entity:this.entity.name,options:e},`Counting entities`);let t=this.buildCountCacheKey(e?.where);if(this.countCache){let e=this.countCache.get(t);if(e!==void 0)return this.logger?.debug?.({entity:this.entity.name,cached:e},`Count cache hit`),e}let n=this.db.select({count:c`count(*)`}).from(this.table).$dynamic();e?.where&&(n=n.where(e.where));let[r]=await n,i=Number(r.count);return this.countCache&&this.countCache.set(t,i),i}async update(e,t,r){this.logger?.info({entity:this.entity.name,id:e},`Updating entity`);let i=t;if(this.entity.hooks?.beforeUpdate){let t=await this.entity.hooks.beforeUpdate(e,i);i=t===void 0?i:t}i=this.updateSchema.parse(i);let a=this.prepareDataForUpdate(i),o;if(Object.keys(a).length>0){let[t]=await this.db.update(this.table).set(a).where(n(this.table.id,e)).returning();o=t}else{let[t]=await this.db.select().from(this.table).where(n(this.table.id,e));o=t}await this.saveBlocks(e,i,r),await this.syncRefs(e,i,`update`),this.entity.hooks?.afterUpdate&&await this.entity.hooks.afterUpdate(o);let s=g(this.entity,o);if(s&&this.getBlocksFields().length>0){let t=await this.loadBlocks([e]);this.attachBlocks([s],t)}return s}async delete(e){this.logger?.info({entity:this.entity.name,id:e},`Deleting entity`);let r=await S(this.entity.name,e,this.db);if(r.length>0)throw new v(this.entity.name,e,r);this.entity.hooks?.beforeDelete&&await this.entity.hooks.beforeDelete(e),await this.db.delete(this.table).where(n(this.table.id,e)),await this.db.delete(x).where(t(n(x.sourceEntity,this.entity.name),n(x.sourceId,e))),this.entity.hooks?.afterDelete&&await this.entity.hooks.afterDelete(e),this.invalidateCountCache()}prepareDataForInsert(e){let t={};for(let[n,r]of Object.entries(e)){let e=this.entity.allFields[n];e&&n!==`id`&&e.type!==`blocks`&&(t[n]=r)}return t}prepareDataForUpdate(e){let t={};for(let[n,r]of Object.entries(e)){let e=this.entity.allFields[n];e&&n!==`id`&&e.type!==`blocks`&&(t[n]=r)}return t}async mergeTranslations(r,a){if(!r.length)return r;let o=`${this.entity.name}_translations`,s=e.get(o);if(!s)return r;let c=r.map(e=>e.id),l=await this.db.select().from(s).where(t(i(s.entityId,c),n(s.locale,a))),u=Object.entries(this.entity.allFields).filter(([e,t])=>t.translatable).map(([e])=>e),d=new Map;for(let e of l){let t={};for(let n of u){let r=e[n];r!=null&&(t[n]=r)}d.set(e.entityId,t)}return r.map(e=>{let t=d.get(e.id);return t?{...e,...t}:e})}async saveTranslation(t,n,r){this.logger?.info({entity:this.entity.name,entityId:t,locale:n},`Saving translation`);let i=`${this.entity.name}_translations`,a=e.get(i);if(!a)throw Error(`Translation table ${i} not found in schema registry`);let o=Object.entries(this.entity.allFields).filter(([e,t])=>t.translatable).map(([e])=>e);if(o.length===0)throw Error(`Entity ${this.entity.name} has no translatable fields`);let s={entityId:t,locale:n},c={};for(let e of o)r[e]!==void 0&&(s[e]=r[e],c[e]=r[e]);await this.db.insert(a).values(s).onConflictDoUpdate({target:[a.entityId,a.locale],set:c}),this.logger?.info({entity:this.entity.name,entityId:t,locale:n},`Translation saved`)}async deleteTranslation(r,i){this.logger?.info({entity:this.entity.name,entityId:r,locale:i},`Deleting translation`);let a=`${this.entity.name}_translations`,o=e.get(a);if(!o)throw Error(`Translation table ${a} not found in schema registry`);i?(await this.db.delete(o).where(t(n(o.entityId,r),n(o.locale,i))),this.logger?.info({entity:this.entity.name,entityId:r,locale:i},`Translation deleted`)):(await this.db.delete(o).where(n(o.entityId,r)),this.logger?.info({entity:this.entity.name,entityId:r},`All translations deleted`))}async saveBlockTranslations(r,i,o){this.logger?.info({entity:this.entity.name,entityId:r,locale:i},`Saving block translations`);let s=this.getBlocksFields();if(s.length===0)return;let c=e.get(`${this.entity.name}_layout_translations`);if(!c)return;let l=e.get(`${this.entity.name}_layout`);if(l){for(let{name:e,config:u}of s){let s=o[e];if(!Array.isArray(s))continue;let d=u.blocks;if(!d)continue;let f=await this.db.select({id:l.id,blockType:l.blockType}).from(l).where(t(n(l.entityId,r),n(l.fieldName,e),a(l.locale))).orderBy(l.sortOrder);for(let e=0;e<s.length;e++){let t=s[e],n=t._block;if(!n)continue;let r=f[e];if(!r||r.blockType!==n)continue;let a=d.find(e=>e.slug===n);if(!a)continue;let o={};for(let[e,n]of Object.entries(a.fields))n.translatable&&t[e]!==void 0&&(o[e]=t[e]);Object.keys(o).length!==0&&await this.db.insert(c).values({layoutId:r.id,locale:i,fields:o}).onConflictDoUpdate({target:[c.layoutId,c.locale],set:{fields:o}})}}this.logger?.info({entity:this.entity.name,entityId:r,locale:i},`Block translations saved`)}}async saveLocalizedBlocks(e,t,n){this.logger?.info({entity:this.entity.name,entityId:e,locale:t},`Saving localized blocks`),await this.saveBlocks(e,n,{locale:t})}getBlocksFields(){return Object.entries(this.entity.allFields).filter(([e,t])=>t.type===`blocks`).map(([e,t])=>({name:e,config:t}))}async saveBlocks(r,i,o){let s=this.getBlocksFields();if(s.length===0)return;let c=e.get(`${this.entity.name}_layout`);if(c)for(let{name:e,config:l}of s){let s=i[e];if(!Array.isArray(s))continue;let u=`localized`in l&&l.localized===!0,d=u?o?.locale??null:null,f=[n(c.entityId,r),n(c.fieldName,e)];d?f.push(n(c.locale,d)):u||f.push(a(c.locale)),await this.db.delete(c).where(t(...f));for(let t=0;t<s.length;t++){let n=s[t],i=n._block;if(!i)continue;let{_block:a,_id:o,...l}=n;await this.db.insert(c).values({entityId:r,fieldName:e,blockType:i,sortOrder:t,data:l,locale:d})}}}async loadBlocks(r,o,c){let l=this.getBlocksFields();if(l.length===0||r.length===0)return new Map;let u=e.get(`${this.entity.name}_layout`);if(!u)return new Map;let d=l.filter(({config:e})=>!(`localized`in e&&e.localized)),f=l.filter(({config:e})=>`localized`in e&&e.localized),p=new Map;if(d.length>0){let s=await this.db.select().from(u).where(t(i(u.entityId,r),a(u.locale))).orderBy(u.sortOrder),c;if(o&&s.length>0){let r=e.get(`${this.entity.name}_layout_translations`);if(r){let e=s.map(e=>e.id),a=await this.db.select().from(r).where(t(i(r.layoutId,e),n(r.locale,o)));c=new Map;for(let e of a)c.set(e.layoutId,e.fields??{})}}let l=new Map;for(let{config:e}of d){let t=e.blocks;if(t)for(let e of t)l.set(e.slug,e.fields)}for(let e of s){let t=e.entityId,n=e.fieldName;p.has(t)||p.set(t,{});let r=p.get(t);r[n]||(r[n]=[]);let i=e.data??{},a=c?.get(e.id),s={_block:e.blockType,_id:e.id,...i,...a??{}};if(o){let t=e.blockType,n=l.get(t);if(n)for(let[e,t]of Object.entries(n))t.translatable&&!a?.[e]&&(s[e]=``)}r[n].push(s)}}if(f.length>0){let e=!o||o===c?.defaultLocale,l=o?e?s(n(u.locale,o),a(u.locale)):n(u.locale,o):a(u.locale),d=await this.db.select().from(u).where(t(i(u.entityId,r),l)).orderBy(u.sortOrder),f=new Map;for(let e of d){let t=`${e.entityId}::${e.fieldName}`;f.has(t)||f.set(t,{localeRows:[],nullRows:[]});let n=f.get(t);e.locale?n.localeRows.push(e):n.nullRows.push(e)}for(let[,{localeRows:e,nullRows:t}]of f){let n=e.length>0?e:t;for(let e of n){let t=e.entityId,n=e.fieldName;p.has(t)||p.set(t,{});let r=p.get(t);r[n]||(r[n]=[]);let i=e.data??{};r[n].push({_block:e.blockType,_id:e.id,...i})}}}return p}attachBlocks(e,t){let n=this.getBlocksFields();if(n.length!==0)for(let r of e){let e=r.id,i=t.get(e)??{};for(let{name:e}of n)r[e]=i[e]??[]}}async syncRefs(r,a,o){if(!e.has(`entity_refs`))return;let s=this.entity.allFields;if(o===`update`){let e=Object.keys(a).filter(e=>{let t=s[e];return t&&(t.type===`media`||t.type===`reference`||t.type===`blocks`)});e.length>0&&await this.db.delete(x).where(t(n(x.sourceEntity,this.entity.name),n(x.sourceId,r),i(x.sourceField,e)))}let c=b(s,a);c.length>0&&await this.db.insert(x).values(c.map(e=>({sourceEntity:this.entity.name,sourceId:r,sourceField:e.sourceField,targetEntity:e.targetEntity,targetId:e.targetId}))).onConflictDoNothing()}buildCountCacheKey(e){return e?`${this.entity.name}:${String(e)}`:this.entity.name}invalidateCountCache(){this.countCache?.invalidate(this.entity.name)}};export{E as AdminClient};
+//# sourceMappingURL=index.mjs.map