@beechcms/core 0.9.6 → 0.9.7

package/dist/content/content-lock.repository.d.ts

@@ -1,63 +0,0 @@
-/** Lock lifetime in seconds. Brief §2: strictly enforced, not configurable per seed. */
-export declare const LOCK_TTL_SECONDS = 180;
-/** Identity persisted alongside a lock so a blocked caller can be told who holds it. */
-export interface LockHolder {
-    userId: string;
-    /** Display name, when the account has one. Never used for authorization. */
-    name: string | null;
-    email: string | null;
-}
-/** A lock row as the API exposes it. All timestamps are Unix epoch SECONDS. */
-export interface ContentLock {
-    seedSlug: string;
-    entryId: string;
-    holder: LockHolder;
-    acquiredAt: number;
-    expiresAt: number;
-}
-/**
- * Outcome of an acquisition attempt. `ok: false` always carries the live lock that
- * blocked it, which is what the 423 response body is built from.
- */
-export type LockAcquisition = {
-    ok: true;
-    lock: ContentLock;
-} | {
-    ok: false;
-    heldBy: ContentLock;
-};
-/**
- * Storage port for pessimistic entry locks.
- *
- * Deliberately NOT part of `ContentRepository`: that interface is referenced by
- * `HookContext` and `JobContext`, so widening it would break every user-authored
- * hook and background job handler.
- *
- * Every `nowSeconds` argument is the caller's clock reading, never the database's:
- * expiry must be deterministic under the test harness's `FixedClock`.
- */
-export interface IContentLockRepository {
-    /**
-     * Takes the lock, or extends it when the caller already holds it. An expired row is
-     * overwritten in the same statement — this is the lazy expiration of brief §4.
-     */
-    acquire(seedSlug: string, entryId: string, holder: LockHolder, nowSeconds: number, ttlSeconds: number): Promise<LockAcquisition>;
-    /**
-     * Extends a lock the caller currently holds. Returns null when the lock has already
-     * expired or has been taken over — the heartbeat's signal that the lock was LOST,
-     * which `acquire` would silently paper over by re-taking it.
-     */
-    renew(seedSlug: string, entryId: string, userId: string, nowSeconds: number, ttlSeconds: number): Promise<ContentLock | null>;
-    /** Drops the lock only if `userId` holds it. Returns false when it did not. */
-    release(seedSlug: string, entryId: string, userId: string): Promise<boolean>;
-    /** The live lock, or null when none is held or the stored one has expired. */
-    find(seedSlug: string, entryId: string, nowSeconds: number): Promise<ContentLock | null>;
-}
-/** True when `lock` exists and has not yet expired at `nowSeconds`. */
-export declare function isLockActive(lock: ContentLock | null, nowSeconds: number): boolean;
-/**
- * True when `userId` is the live holder. A null `userId` (the Public API, which has no
- * authenticated subject) is never a holder.
- */
-export declare function isLockHeldBy(lock: ContentLock | null, userId: string | null, nowSeconds: number): boolean;
-//# sourceMappingURL=content-lock.repository.d.ts.map

package/dist/content/content-lock.repository.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"content-lock.repository.d.ts","sourceRoot":"","sources":["../../src/content/content-lock.repository.ts"],"names":[],"mappings":"AAGA,wFAAwF;AACxF,eAAO,MAAM,gBAAgB,MAAM,CAAA;AAEnC,wFAAwF;AACxF,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,4EAA4E;IAC5E,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB;AAED,+EAA+E;AAC/E,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,UAAU,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;;GAGG;AACH,MAAM,MAAM,eAAe,GACvB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,WAAW,CAAA;CAAE,GAC/B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,CAAA;AAEtC;;;;;;;;;GASG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,OAAO,CACL,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,UAAU,EAClB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,eAAe,CAAC,CAAA;IAE3B;;;;OAIG;IACH,KAAK,CACH,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;IAE9B,+EAA+E;IAC/E,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAE5E,8EAA8E;IAC9E,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;CACzF;AAED,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAElF;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,WAAW,GAAG,IAAI,EACxB,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,UAAU,EAAE,MAAM,GACjB,OAAO,CAET"}

package/dist/content/content-lock.repository.js

@@ -1,15 +0,0 @@
-// SPDX-License-Identifier: MIT
-// Copyright (c) 2024–2026 Flavio De Musso
-/** Lock lifetime in seconds. Brief §2: strictly enforced, not configurable per seed. */
-export const LOCK_TTL_SECONDS = 180;
-/** True when `lock` exists and has not yet expired at `nowSeconds`. */
-export function isLockActive(lock, nowSeconds) {
-    return lock !== null && lock.expiresAt > nowSeconds;
-}
-/**
- * True when `userId` is the live holder. A null `userId` (the Public API, which has no
- * authenticated subject) is never a holder.
- */
-export function isLockHeldBy(lock, userId, nowSeconds) {
-    return isLockActive(lock, nowSeconds) && userId !== null && lock.holder.userId === userId;
-}