hikoutei 0.5.20 → 0.5.21

package/dist/application/orm/api/contracts.d.ts

@@ -1,118 +0,0 @@
-/**
- * Public lifecycle contracts for the typed-sheets ORM facade.
- *
- * They intentionally describe our entity lifecycle rather than any concrete
- * ORM implementation, so a SQLite execution adapter can change without
- * changing the application's `em.persist()` / `em.flush()` workflow.
- */
-import { type Presence } from "../../../shared/state/index.js";
-import type { SqlExecutor } from "../../../adapter/persistence/contracts/sql.js";
-/** Constructor accepted by the initial entity-style public API. */
-export interface TypedSheetsEntityClass<Entity extends object> {
-    new (...arguments_: never[]): Entity;
-}
-/** Stable entity reference accepted by our EntityManager facade. */
-export type TypedSheetsEntityReference<Entity extends object> = string | TypedSheetsEntityClass<Entity>;
-/** Values used when creating one entity through `em.create()`. */
-export type TypedSheetsEntityData<Entity extends object> = Readonly<Partial<Entity>>;
-/** Equality filter accepted by the initial `find()` and `findOne()` surface. */
-export type TypedSheetsEntityFilter<Entity extends object> = Readonly<Partial<Entity>>;
-/** Read options intentionally supported by the initial public entity API. */
-export interface TypedSheetsFindOptions {
-    readonly limit?: number;
-    readonly offset?: number;
-}
-/** Entity-manager fork behavior supported without leaking the underlying ORM. */
-export interface TypedSheetsForkOptions {
-    /** Starts the fork with an empty identity map when the execution engine supports it. */
-    readonly clear?: boolean;
-}
-/** Callback invoked by one entity execution engine immediately before it writes. */
-export type TypedSheetsEntityFlushListener = (context: TypedSheetsFlushContext) => Promise<void>;
-/**
- * Replaceable internal execution engine for the typed-sheets EntityManager.
- *
- * This is the only extension point an ORM-specific integration must implement.
- * It deliberately uses typed-sheets lifecycle types, never MikroORM types.
- */
-export interface TypedSheetsEntityEngine {
-    /** Opens an isolated manager for one request, job, or unit of work. */
-    fork(): TypedSheetsEntityEngineManager;
-    /** Releases resources owned by the underlying SQLite execution engine. */
-    close(force?: boolean): Promise<void>;
-}
-/** Internal manager operations required to implement the public entity lifecycle. */
-export interface TypedSheetsEntityEngineManager {
-    fork(options?: TypedSheetsForkOptions): TypedSheetsEntityEngineManager;
-    create<Entity extends object>(entityName: TypedSheetsEntityReference<Entity>, data: TypedSheetsEntityData<Entity>): Entity;
-    find<Entity extends object>(entityName: TypedSheetsEntityReference<Entity>, where: TypedSheetsEntityFilter<Entity>, options?: TypedSheetsFindOptions): Promise<readonly Entity[]>;
-    findOne<Entity extends object>(entityName: TypedSheetsEntityReference<Entity>, where: TypedSheetsEntityFilter<Entity>, options?: TypedSheetsFindOptions): Promise<Entity | null>;
-    persist<Entity extends object>(entity: Entity | Iterable<Entity>): void;
-    remove<Entity extends object>(entity: Entity | Iterable<Entity>): void;
-    flush(): Promise<void>;
-    transactional<Result>(operation: (entityManager: TypedSheetsEntityEngineManager) => Promise<Result>): Promise<Result>;
-    clear(): void;
-    isInTransaction(): boolean;
-    begin(): Promise<void>;
-    commit(): Promise<void>;
-    rollback(): Promise<void>;
-    /** Registers the typed-sheets plan to run in the engine's active flush transaction. */
-    onFlush(listener: TypedSheetsEntityFlushListener): void;
-}
-/** Runtime values for durable entity changes observed during one flush. */
-export declare const TYPED_SHEETS_ENTITY_CHANGE_KINDS: {
-    readonly CREATE: "create";
-    readonly UPDATE: "update";
-    readonly DELETE: "delete";
-};
-/** Closed set of entity lifecycle changes handled by the typed-sheets ORM. */
-export type TypedSheetsEntityChangeKind = (typeof TYPED_SHEETS_ENTITY_CHANGE_KINDS)[keyof typeof TYPED_SHEETS_ENTITY_CHANGE_KINDS];
-/** Values captured from one MikroORM changeset before it reaches persistence. */
-export type TypedSheetsEntityChangePayload = Readonly<Record<string, unknown>>;
-/** Shared data carried by every normalized entity lifecycle change. */
-export interface TypedSheetsEntityChangeBase {
-    readonly entityName: string;
-    readonly entity: object;
-    readonly primaryKey: Presence<string>;
-    /** Changed scalar values for updates and persisted values for inserts. */
-    readonly payload: TypedSheetsEntityChangePayload;
-}
-/** Entity was newly managed and will be inserted during the current flush. */
-export interface TypedSheetsCreatedEntityChange extends TypedSheetsEntityChangeBase {
-    readonly kind: typeof TYPED_SHEETS_ENTITY_CHANGE_KINDS.CREATE;
-}
-/** Existing entity fields changed during the current flush. */
-export interface TypedSheetsUpdatedEntityChange extends TypedSheetsEntityChangeBase {
-    readonly kind: typeof TYPED_SHEETS_ENTITY_CHANGE_KINDS.UPDATE;
-}
-/** Existing entity was marked for removal during the current flush. */
-export interface TypedSheetsDeletedEntityChange extends TypedSheetsEntityChangeBase {
-    readonly kind: typeof TYPED_SHEETS_ENTITY_CHANGE_KINDS.DELETE;
-}
-/**
- * One normalized entity change collected from a single `flush()` operation.
- *
- * The discriminant keeps lifecycle branching explicit for coordinators while
- * the adapter-specific changeset shape remains outside the public contract.
- */
-export type TypedSheetsEntityChange = TypedSheetsCreatedEntityChange | TypedSheetsUpdatedEntityChange | TypedSheetsDeletedEntityChange;
-/** Context available to the typed-sheets sync planner during an entity flush. */
-export interface TypedSheetsFlushContext {
-    /** All entity changes in the current Unit of Work. */
-    readonly changes: readonly TypedSheetsEntityChange[];
-    /** SQL executor bound to the same transaction as the entity writes. */
-    readonly sql: SqlExecutor;
-}
-/**
- * Converts durable entity changes into typed-sheets canonical and outbox work.
- *
- * The coordinator runs before entity rows are flushed, but within the same
- * SQLite transaction. Throwing aborts both the entity write and every
- * typed-sheets write scheduled through `context.sql`.
- */
-export interface TypedSheetsFlushCoordinator {
-    onFlush(context: TypedSheetsFlushContext): Promise<void>;
-}
-/** Converts a database-generated primary-key value into the public presence contract. */
-export declare function primaryKeyPresence(primaryKey: string | null): Presence<string>;
-//# sourceMappingURL=contracts.d.ts.map

package/dist/application/orm/api/contracts.d.ts.map

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

package/dist/application/orm/api/contracts.js

@@ -1,21 +0,0 @@
-/**
- * Public lifecycle contracts for the typed-sheets ORM facade.
- *
- * They intentionally describe our entity lifecycle rather than any concrete
- * ORM implementation, so a SQLite execution adapter can change without
- * changing the application's `em.persist()` / `em.flush()` workflow.
- */
-import { PRESENCE_KINDS, } from "../../../shared/state/index.js";
-/** Runtime values for durable entity changes observed during one flush. */
-export const TYPED_SHEETS_ENTITY_CHANGE_KINDS = {
-    CREATE: "create",
-    UPDATE: "update",
-    DELETE: "delete",
-};
-/** Converts a database-generated primary-key value into the public presence contract. */
-export function primaryKeyPresence(primaryKey) {
-    return primaryKey === null
-        ? { kind: PRESENCE_KINDS.ABSENT }
-        : { kind: PRESENCE_KINDS.PRESENT, value: primaryKey };
-}
-//# sourceMappingURL=contracts.js.map

package/dist/application/orm/api/contracts.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../../src/application/orm/api/contracts.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,cAAc,GAEf,MAAM,gCAAgC,CAAC;AAiFxC,2EAA2E;AAC3E,MAAM,CAAC,MAAM,gCAAgC,GAAG;IAC9C,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;CACR,CAAC;AA+DX,yFAAyF;AACzF,MAAM,UAAU,kBAAkB,CAAC,UAAyB;IAC1D,OAAO,UAAU,KAAK,IAAI;QACxB,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,MAAM,EAAE;QACjC,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AAC1D,CAAC"}