@heavybit/shared-lib 2.1.0 → 2.7.0

package/dist/types/database/pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../../../src/database/pool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,KAAK,MAAM,gBAAgB,CAAC;AAEnC,oFAAoF;AACpF,MAAM,WAAW,sBAAsB;IACrC,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,sDAAsD;AACtD,MAAM,WAAW,iBAAkB,SAAQ,sBAAsB;IAC/D,kDAAkD;IAClD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,KAAK,CAAC,IAAI,CAe3E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAC,MAAM,CAgBxE;AAED,8BAA8B;AAC9B,wBAAsB,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/D;AAED,8DAA8D;AAC9D,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD"}

package/dist/types/database/scoped-repository.d.ts

@@ -0,0 +1,92 @@
+import { type InferInsertModel, type InferSelectModel, type SQL } from 'drizzle-orm';
+import type { MySqlColumn, MySqlDatabase, MySqlTable } from 'drizzle-orm/mysql-core';
+import type { CursorPage } from '../types/index.js';
+import { type RowScope } from './scopes.js';
+/**
+ * Any Drizzle MySQL executor: the database or a transaction handle (`Tx`).
+ * Typed loosely on purpose so repositories work with every service schema.
+ */
+export type DbExecutor = MySqlDatabase<any, any, any, any>;
+/** Optional transaction for a repository call. */
+export interface TxOption {
+    /** Run inside this transaction instead of on the pool. */
+    tx?: DbExecutor;
+}
+/** Sort for {@link ScopedRepository.findMany}. `column` is a database column name. */
+export interface SortSpec {
+    column: string;
+    direction?: 'asc' | 'desc';
+}
+/** Options for {@link ScopedRepository.findMany} and {@link ScopedRepository.findPage}. */
+export interface FindManyOptions extends TxOption {
+    /** Extra conditions (AND-ed with the scope). */
+    where?: SQL;
+    /** Sort column (default: the id column, descending). The id is always the tie-breaker. */
+    orderBy?: SortSpec;
+    /** Opaque cursor from a previous page. */
+    cursor?: string;
+    /** Page size, 1–100 (default 20). */
+    limit?: number;
+}
+/** Options for {@link ScopedRepository}. */
+export interface ScopedRepositoryOptions {
+    /** Database name of the primary-key column (default `id`). */
+    idColumn?: string;
+}
+/**
+ * Base for every repository over scoped data (Drizzle). Every read, count, update and delete is
+ * AND-ed with the scope's condition, and every insert is stamped with the scope value; there is no
+ * method that returns an unscoped query. Subclasses add queries only through {@link scoped} and
+ * {@link executor}.
+ *
+ * @example
+ * class NoteRepository extends ScopedRepository<typeof notes, ScopeContext<'workspaceId'>> {
+ *   findByTitle(ctx: ScopeContext<'workspaceId'>, title: string) {
+ *     return this.executor().select().from(this.table).where(this.scoped(ctx, eq(this.table.title, title)));
+ *   }
+ * }
+ * const repo = new NoteRepository(db, notes, workspaceScope);
+ */
+export declare class ScopedRepository<TTable extends MySqlTable, TCtx> {
+    #private;
+    protected readonly table: TTable;
+    protected readonly scope: RowScope<TCtx>;
+    protected readonly idColumn: MySqlColumn;
+    constructor(db: DbExecutor, table: TTable, scope: RowScope<TCtx>, options?: ScopedRepositoryOptions);
+    /** The row with `id` inside the caller's scope, or null (absent and out-of-scope look the same). */
+    findById(ctx: TCtx, id: string, options?: TxOption): Promise<InferSelectModel<TTable> | null>;
+    /** Rows inside the caller's scope, keyset-paginated by `orderBy` then id. */
+    findMany(ctx: TCtx, options?: FindManyOptions): Promise<InferSelectModel<TTable>[]>;
+    /** Like {@link findMany}, returning `{ data, meta: { limit, nextCursor, hasMore } }`. */
+    findPage(ctx: TCtx, options?: FindManyOptions): Promise<CursorPage<InferSelectModel<TTable>>>;
+    /** Number of rows inside the caller's scope matching `where`. */
+    count(ctx: TCtx, where?: SQL, options?: TxOption): Promise<number>;
+    /**
+     * Inserts rows stamped with the caller's scope value.
+     *
+     * @throws ForbiddenError (`SCOPE_MISMATCH`) when a row names another scope.
+     * @returns The stamped rows as written.
+     */
+    insert(ctx: TCtx, rows: InferInsertModel<TTable> | InferInsertModel<TTable>[], options?: TxOption): Promise<InferInsertModel<TTable>[]>;
+    /**
+     * Updates rows inside the caller's scope. Rows never move between scopes.
+     *
+     * @throws ForbiddenError (`SCOPE_IMMUTABLE`) when `values` sets the scope column.
+     * @returns Number of rows changed.
+     */
+    update(ctx: TCtx, where: SQL, values: Partial<InferInsertModel<TTable>>, options?: TxOption): Promise<number>;
+    /**
+     * Deletes rows inside the caller's scope.
+     *
+     * @returns Number of rows deleted.
+     */
+    delete(ctx: TCtx, where: SQL, options?: TxOption): Promise<number>;
+    /** The scope condition AND-ed with `conditions`. The only way subclasses may build a WHERE. */
+    protected scoped(ctx: TCtx, ...conditions: Array<SQL | undefined>): SQL;
+    /** The executor for a call: `tx` when given, otherwise the pool. Always pair with {@link scoped}. */
+    protected executor(tx?: DbExecutor): DbExecutor;
+    private selectPage;
+    /** Keyset condition: rows strictly after the cursor's (sortKey, id) in the sort direction. */
+    private afterCursor;
+}
+//# sourceMappingURL=scoped-repository.d.ts.map

package/dist/types/database/scoped-repository.d.ts.map

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

package/dist/types/database/scopes.d.ts

@@ -0,0 +1,159 @@
+import { type SQL } from 'drizzle-orm';
+import type { MySqlColumn, MySqlTable } from 'drizzle-orm/mysql-core';
+/**
+ * Row scopes: the only ways a {@link ScopedRepository} can reach rows. Each scope turns a request
+ * context into a Drizzle condition on one scope column and stamps that column on insert.
+ *
+ * - {@link defineScope}: rows belong to the scope value carried by the context (e.g. a workspace).
+ * - {@link OwnerScope}: rows belong to one owner (a user id column); a missing owner id is refused.
+ * - {@link PlatformScope}: cross-scope access, issued only when a caller-supplied predicate approves
+ *   the identity. It still filters on the scope column (`IS NOT NULL`), so every query names it.
+ *
+ * App bindings (which column, which context key, who is a platform admin) live in the app's
+ * contracts package, never here.
+ */
+/** A scope a repository is bound to. `TCtx` is what each call must carry to prove its scope. */
+export interface RowScope<TCtx> {
+    /** Readable name, used in error messages and logs (e.g. `workspace`). */
+    readonly name: string;
+    /** Database column name that holds the scope value (e.g. `workspace_id`). */
+    readonly column: string;
+    /**
+     * Condition restricting `table` to the rows `ctx` may reach.
+     *
+     * @throws ForbiddenError when `ctx` does not carry a usable scope value.
+     */
+    condition(table: MySqlTable, ctx: TCtx): SQL;
+    /**
+     * Returns `row` with the scope column set from `ctx`.
+     *
+     * @throws ForbiddenError when the row already carries a different scope value.
+     */
+    stamp<TRow extends Record<string, unknown>>(table: MySqlTable, row: TRow, ctx: TCtx): TRow;
+}
+/** Request context for a {@link defineScope} scope: `{ [contextKey]: scopeValue }`. */
+export type ScopeContext<TKey extends string = string> = {
+    readonly [K in TKey]: string | null | undefined;
+};
+/** Options for {@link defineScope}. */
+export interface ScopeDefinitionOptions<TKey extends string> {
+    /** Readable name (e.g. `workspace`). */
+    name: string;
+    /** Database column name (e.g. `workspace_id`). */
+    column: string;
+    /** Context property that carries the scope value (e.g. `workspaceId`). */
+    contextKey: TKey;
+}
+/** A scope created by {@link defineScope}. */
+export interface ScopeDefinition<TKey extends string = string> extends RowScope<ScopeContext<TKey>> {
+    /** Context property that carries the scope value. */
+    readonly contextKey: TKey;
+    /**
+     * The scope value from `ctx`.
+     *
+     * @throws ForbiddenError (`SCOPE_REQUIRED`) when it is missing or empty.
+     */
+    valueOf(ctx: ScopeContext<TKey>): string;
+}
+/** A table column located by its database name, with the property key Drizzle uses for it. */
+export interface ResolvedColumn {
+    /** Property key on the Drizzle table (e.g. `workspaceId`). */
+    key: string;
+    /** The Drizzle column, for building conditions. */
+    column: MySqlColumn;
+}
+/**
+ * Finds a table column by its database name.
+ *
+ * @throws Error when the table has no such column (a wiring bug, caught at startup or in tests).
+ */
+export declare function resolveColumn(table: MySqlTable, dbName: string): ResolvedColumn;
+/**
+ * Defines a scope whose value comes from the request context (the gateway-signed identity, never a
+ * request body).
+ *
+ * @example const workspaceScope = defineScope({ name: 'workspace', column: 'workspace_id', contextKey: 'workspaceId' });
+ */
+export declare function defineScope<TKey extends string>(options: ScopeDefinitionOptions<TKey>): ScopeDefinition<TKey>;
+/** Context for an {@link OwnerScope}: the owner's id (from the signed identity). */
+export interface OwnerContext {
+    readonly ownerId: string | null | undefined;
+}
+/**
+ * Rows owned by one principal (e.g. a user's own records). Refuses a missing owner id, so an
+ * anonymous call can never fall through to "all owners".
+ *
+ * @example const ownerScope = new OwnerScope({ name: 'owner', column: 'user_id' });
+ */
+export declare class OwnerScope implements RowScope<OwnerContext> {
+    /** Readable name (e.g. `owner`). */
+    readonly name: string;
+    /** Database name of the owner column (e.g. `user_id`). */
+    readonly column: string;
+    /** @param options `name` for messages, `column` = database name of the owner column. */
+    constructor(options: {
+        name: string;
+        column: string;
+    });
+    /** The owner id from `ctx`; throws ForbiddenError (`OWNER_REQUIRED`) when it is missing. */
+    ownerIdOf(ctx: OwnerContext): string;
+    /** `owner column = ownerId`. @throws ForbiddenError (`OWNER_REQUIRED`) without an owner id. */
+    condition(table: MySqlTable, ctx: OwnerContext): SQL;
+    /** Sets the owner column. @throws ForbiddenError (`OWNER_REQUIRED`, `SCOPE_MISMATCH`). */
+    stamp<TRow extends Record<string, unknown>>(table: MySqlTable, row: TRow, ctx: OwnerContext): TRow;
+}
+/** Options for {@link definePlatformScope}. */
+export interface PlatformScopeOptions<TIdentity> {
+    /** Readable name (e.g. `platform`). */
+    name: string;
+    /** The scope column the platform scope spans (e.g. `workspace_id`). */
+    column: string;
+    /** Decides whether an identity may read across scopes (e.g. "is a platform admin"). */
+    predicate: (identity: TIdentity) => boolean;
+}
+declare const ISSUE: unique symbol;
+/**
+ * Proof that an identity may act across scopes. Only {@link PlatformScopeDefinition.authorize} can
+ * create one, and only when the definition's predicate approves the identity.
+ */
+export declare class PlatformScope {
+    #private;
+    /** @internal Use `definePlatformScope(...).authorize(identity)`. */
+    constructor(token: typeof ISSUE, definition: PlatformScopeDefinition<never>);
+    /** True when this grant was issued by `definition`. */
+    issuedBy(definition: PlatformScopeDefinition<never>): boolean;
+}
+/**
+ * Cross-scope access for platform operators. Rows of every scope are reachable, but the query still
+ * filters on the scope column (`IS NOT NULL`) and inserts must name their scope explicitly.
+ */
+export declare class PlatformScopeDefinition<TIdentity> implements RowScope<PlatformScope> {
+    #private;
+    /** Readable name (e.g. `platform`). */
+    readonly name: string;
+    /** Database name of the scope column the platform scope spans. */
+    readonly column: string;
+    /** Prefer {@link definePlatformScope}. */
+    constructor(options: PlatformScopeOptions<TIdentity>);
+    /**
+     * Issues a {@link PlatformScope} for `identity`.
+     *
+     * @throws ForbiddenError (`PLATFORM_SCOPE_DENIED`) when the predicate refuses (or throws).
+     */
+    authorize(identity: TIdentity | null | undefined): PlatformScope;
+    /** `scope column IS NOT NULL`. @throws ForbiddenError (`PLATFORM_SCOPE_REQUIRED`) without a grant from this scope. */
+    condition(table: MySqlTable, ctx: PlatformScope): SQL;
+    /** Requires the row to name its scope. @throws ForbiddenError (`PLATFORM_SCOPE_REQUIRED`, `SCOPE_REQUIRED`). */
+    stamp<TRow extends Record<string, unknown>>(table: MySqlTable, row: TRow, ctx: PlatformScope): TRow;
+    private assertGrant;
+}
+/**
+ * Defines the platform (cross-scope) scope.
+ *
+ * @example
+ * const platformScope = definePlatformScope({ name: 'platform', column: 'workspace_id', predicate: (u: AuthUser) => u.isSuperAdmin });
+ * const grant = platformScope.authorize(req.user); // throws 403 for anyone else
+ */
+export declare function definePlatformScope<TIdentity>(options: PlatformScopeOptions<TIdentity>): PlatformScopeDefinition<TIdentity>;
+export {};
+//# sourceMappingURL=scopes.d.ts.map

package/dist/types/database/scopes.d.ts.map

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

package/dist/types/database/table-names.d.ts

@@ -0,0 +1,13 @@
+/** Default name of the transactional outbox table. */
+export declare const DEFAULT_OUTBOX_TABLE = "event_outbox";
+/** Default name of the consumer idempotency ledger. */
+export declare const DEFAULT_PROCESSED_EVENTS_TABLE = "processed_events";
+/** Default name of the scheduled-job runs table. */
+export declare const DEFAULT_SCHEDULER_RUNS_TABLE = "scheduler_runs";
+/** Scheduler run states, shared by the Drizzle table and the Knex helper. */
+export declare const SCHEDULER_RUN_STATUSES: readonly ["running", "succeeded", "failed"];
+/** Logical exchanges an outbox row can target: topic events or direct commands. */
+export declare const OUTBOX_EXCHANGES: readonly ["events", "commands"];
+/** One of {@link OUTBOX_EXCHANGES}. */
+export type OutboxExchange = (typeof OUTBOX_EXCHANGES)[number];
+//# sourceMappingURL=table-names.d.ts.map

package/dist/types/database/table-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-names.d.ts","sourceRoot":"","sources":["../../../src/database/table-names.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,eAAO,MAAM,oBAAoB,iBAAiB,CAAC;AACnD,uDAAuD;AACvD,eAAO,MAAM,8BAA8B,qBAAqB,CAAC;AACjE,oDAAoD;AACpD,eAAO,MAAM,4BAA4B,mBAAmB,CAAC;AAC7D,6EAA6E;AAC7E,eAAO,MAAM,sBAAsB,6CAA8C,CAAC;AAClF,mFAAmF;AACnF,eAAO,MAAM,gBAAgB,iCAAkC,CAAC;AAChE,uCAAuC;AACvC,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC"}