@carlonicora/nextjs-jsonapi 6.20.5 → 6.20.6

package/dist/offline/sync/models/OfflineChangeSet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OfflineChangeSet.d.ts","sourceRoot":"","sources":["../../../../src/offline/sync/models/OfflineChangeSet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC1E,OAAO,EAAE,4BAA4B,EAAE,MAAM,uDAAuD,CAAC;AAErG,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAEpH;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,eAAgB,YAAW,yBAAyB;IACxF,OAAO,CAAC,QAAQ,CAAC,CAAwB;IAEzC,IAAI,OAAO,IAAI,mBAAmB,EAAE,CAEnC;IAED,SAAS,CAAC,IAAI,EAAE,4BAA4B,GAAG,IAAI;IAQnD,aAAa,CAAC,IAAI,EAAE,qBAAqB;;;;;;;;;CAS1C"}

package/dist/offline/sync/models/OfflineChangeSetInterface.d.ts

@@ -0,0 +1,53 @@
+import { ApiDataInterface } from "../../../core/interfaces/ApiDataInterface";
+/** One waiting change as the server reads it (C1b, `attributes.changes[]`). */
+export type OfflineChange = {
+    seq: number;
+    method: "POST" | "PUT" | "PATCH" | "DELETE";
+    /** Relative to the API base, as EndpointCreator built it. */
+    path: string;
+    /** The JSON:API document the model built when the GM saved. */
+    body?: Record<string, unknown>;
+    /** Set for an edit or delete of one record. */
+    recordType?: string;
+    recordId?: string;
+    /** The record's JSON:API resource as of the last sync. */
+    base?: Record<string, unknown> | null;
+    /**
+     * Set on a re-sent change after the GM resolved its conflict. The change keeps its original
+     * `body` and `base`; the server runs the normal three-way merge and settles each conflicting
+     * field by `choices` (kind "mine": every conflicting field is "mine").
+     */
+    resolution?: OfflineChangeResolution;
+};
+export type OfflineChangeResolution = {
+    kind: "mine" | "merged";
+    /** Per conflicting field: whose value wins. */
+    choices?: Record<string, "mine" | "theirs" | "merged">;
+    /** The model-built JSON:API document holding only the fields chosen "merged", with their hand-merged values. */
+    mergedBody?: Record<string, unknown>;
+};
+/** The server's answer for one change (C1b, `attributes.results[]`). */
+export type OfflineChangeResult = {
+    seq: number;
+    status: "applied" | "conflict" | "could-not-apply" | "waiting";
+    conflict?: "fields" | "deleted-on-server" | "changed-on-server";
+    /** JSON:API resource as it is now on the server. */
+    current?: Record<string, unknown> | null;
+    /** Attributes the merge settled (for the conflict screen). */
+    merged?: Record<string, unknown>;
+    conflictFields?: string[];
+    /** Rich-text field → conflicting block ids. */
+    conflictBlocks?: Record<string, string[]>;
+    /** The server's reason for could-not-apply. */
+    detail?: string;
+    /** JSON:API document the route answered, when applied. */
+    response?: Record<string, unknown>;
+};
+export type OfflineChangeSetInput = {
+    id: string;
+    changes: OfflineChange[];
+};
+export interface OfflineChangeSetInterface extends ApiDataInterface {
+    get results(): OfflineChangeResult[];
+}
+//# sourceMappingURL=OfflineChangeSetInterface.d.ts.map

package/dist/offline/sync/models/OfflineChangeSetInterface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OfflineChangeSetInterface.d.ts","sourceRoot":"","sources":["../../../../src/offline/sync/models/OfflineChangeSetInterface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAE7E,+EAA+E;AAC/E,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC5C,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACtC;;;;OAIG;IACH,UAAU,CAAC,EAAE,uBAAuB,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;IACxB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC,CAAC;IACvD,gHAAgH;IAChH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC,CAAC;AAEF,wEAAwE;AACxE,MAAM,MAAM,mBAAmB,GAAG;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,iBAAiB,GAAG,SAAS,CAAC;IAC/D,QAAQ,CAAC,EAAE,QAAQ,GAAG,mBAAmB,GAAG,mBAAmB,CAAC;IAChE,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACzC,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC1C,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,aAAa,EAAE,CAAA;CAAE,CAAC;AAE7E,MAAM,WAAW,yBAA0B,SAAQ,gBAAgB;IACjE,IAAI,OAAO,IAAI,mBAAmB,EAAE,CAAC;CACtC"}

package/dist/offline/sync/models/RootSync.d.ts

@@ -0,0 +1,25 @@
+import { AbstractApiData } from "../../../core/abstracts/AbstractApiData";
+import { JsonApiHydratedDataInterface } from "../../../core/interfaces/JsonApiHydratedDataInterface";
+import { RootSyncEntry, RootSyncInterface, RootSyncLink } from "./RootSyncInterface";
+/**
+ * Child path of the sync answer under the root module record
+ * (`GET /<root endpoint>/:id/sync`), the same value as the app API's sync meta endpoint
+ * (in Wyrdli, `campaignSyncMeta.endpoint`).
+ */
+export declare const ROOT_SYNC_ENDPOINT = "sync";
+/** The sync answer for one root record (`root-syncs`, id = root record id). Read-only. */
+export declare class RootSync extends AbstractApiData implements RootSyncInterface {
+    private _serverTime?;
+    private _locked;
+    private _lockedFrom?;
+    private _entries?;
+    private _links?;
+    get serverTime(): Date;
+    get locked(): boolean;
+    get lockedFrom(): Date | undefined;
+    get entries(): RootSyncEntry[];
+    get links(): RootSyncLink[];
+    rehydrate(data: JsonApiHydratedDataInterface): this;
+    createJsonApi(_data?: any): any;
+}
+//# sourceMappingURL=RootSync.d.ts.map

package/dist/offline/sync/models/RootSync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RootSync.d.ts","sourceRoot":"","sources":["../../../../src/offline/sync/models/RootSync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC1E,OAAO,EAAE,4BAA4B,EAAE,MAAM,uDAAuD,CAAC;AACrG,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAErF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,SAAS,CAAC;AAEzC,0FAA0F;AAC1F,qBAAa,QAAS,SAAQ,eAAgB,YAAW,iBAAiB;IACxE,OAAO,CAAC,WAAW,CAAC,CAAO;IAC3B,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,WAAW,CAAC,CAAO;IAC3B,OAAO,CAAC,QAAQ,CAAC,CAAkB;IACnC,OAAO,CAAC,MAAM,CAAC,CAAiB;IAEhC,IAAI,UAAU,IAAI,IAAI,CAGrB;IAED,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,IAAI,UAAU,IAAI,IAAI,GAAG,SAAS,CAEjC;IAED,IAAI,OAAO,IAAI,aAAa,EAAE,CAE7B;IAED,IAAI,KAAK,IAAI,YAAY,EAAE,CAE1B;IAED,SAAS,CAAC,IAAI,EAAE,4BAA4B,GAAG,IAAI;IAwBnD,aAAa,CAAC,KAAK,CAAC,EAAE,GAAG,GAAG,GAAG;CAGhC"}

package/dist/offline/sync/models/RootSyncInterface.d.ts

@@ -0,0 +1,22 @@
+import { ApiDataInterface } from "../../../core/interfaces/ApiDataInterface";
+export type RootSyncEntry = {
+    type: string;
+    id: string;
+    updatedAt: Date;
+};
+export type RootSyncLink = {
+    fromType: string;
+    fromId: string;
+    toType: string;
+    toId: string;
+    kind: string;
+    props: Record<string, unknown>;
+};
+export interface RootSyncInterface extends ApiDataInterface {
+    get serverTime(): Date;
+    get locked(): boolean;
+    get lockedFrom(): Date | undefined;
+    get entries(): RootSyncEntry[];
+    get links(): RootSyncLink[];
+}
+//# sourceMappingURL=RootSyncInterface.d.ts.map

package/dist/offline/sync/models/RootSyncInterface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RootSyncInterface.d.ts","sourceRoot":"","sources":["../../../../src/offline/sync/models/RootSyncInterface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAE7E,MAAM,MAAM,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,IAAI,CAAA;CAAE,CAAC;AAE1E,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC;AAEF,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB;IACzD,IAAI,UAAU,IAAI,IAAI,CAAC;IACvB,IAAI,MAAM,IAAI,OAAO,CAAC;IACtB,IAAI,UAAU,IAAI,IAAI,GAAG,SAAS,CAAC;IACnC,IAAI,OAAO,IAAI,aAAa,EAAE,CAAC;IAC/B,IAAI,KAAK,IAAI,YAAY,EAAE,CAAC;CAC7B"}

package/dist/offline/sync/models/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./RootSync";
+export * from "./RootSyncInterface";
+export * from "./OfflineChangeSet";
+export * from "./OfflineChangeSetInterface";
+export * from "./offline.modules";
+//# sourceMappingURL=index.d.ts.map

package/dist/offline/sync/models/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/offline/sync/models/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mBAAmB,CAAC"}

package/dist/offline/sync/models/offline.modules.d.ts

@@ -0,0 +1,11 @@
+import { ModuleFactory, ModuleWithPermissions } from "../../../permissions/types";
+/**
+ * The offline resources, as one object an app that opts into offline mode
+ * spreads into its `allModules` (same rationale as `analyticsModules`).
+ * Neither has a pageUrl: these are not navigable resources.
+ */
+export declare const offlineModules: (factory: ModuleFactory) => {
+    OfflineChangeSet: ModuleWithPermissions;
+    RootSync: ModuleWithPermissions;
+};
+//# sourceMappingURL=offline.modules.d.ts.map

package/dist/offline/sync/models/offline.modules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"offline.modules.d.ts","sourceRoot":"","sources":["../../../../src/offline/sync/models/offline.modules.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAIlF;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,SAAS,aAAa;;;CAID,CAAC"}

package/dist/offline/sync/runtime.d.ts

@@ -0,0 +1,11 @@
+/** Stops every running offline runtime (timers, listeners). Called on logout. */
+export declare function stopOfflineRuntime(): void;
+/**
+ * Starts the offline runtime: drain-then-sync on open (online) and on every reconnect, syncAll
+ * every `syncIntervalMs` while online, a probe of the API while the session is offline but the
+ * browser is online (a probe that reaches the API runs the drain and the sync, and the session
+ * goes online once they succeeded), and the lock dates checked every minute. Returns the stop
+ * function.
+ */
+export declare function startOfflineRuntime(): () => void;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/offline/sync/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/offline/sync/runtime.ts"],"names":[],"mappings":"AAiHA,iFAAiF;AACjF,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,IAAI,CAqGhD"}

package/dist/offline/sync/session-refresh.d.ts

@@ -0,0 +1,14 @@
+/** The locale of the page the GM is on (first path segment), or the app's default locale. */
+export declare function currentLocale(): string;
+export type SessionRefreshResult = "ok" | "expired" | "unreachable";
+/**
+ * Renews the sign-in before the waiting changes are sent: one same-origin GET of the offline
+ * shell (`cache: "no-store"`). It passes through the app's proxy, which renews the `token`
+ * cookie; the shell path is public, so the proxy never redirects it. The sign-in has expired
+ * when the `token` cookie is absent after the request.
+ *
+ * This is the one `fetch` of the offline layer: a request to the web app itself, not the API
+ * (Carlo's decision, 2026-11-01).
+ */
+export declare function refreshSession(): Promise<SessionRefreshResult>;
+//# sourceMappingURL=session-refresh.d.ts.map

package/dist/offline/sync/session-refresh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-refresh.d.ts","sourceRoot":"","sources":["../../../src/offline/sync/session-refresh.ts"],"names":[],"mappings":"AAIA,6FAA6F;AAC7F,wBAAgB,aAAa,IAAI,MAAM,CAItC;AAED,MAAM,MAAM,oBAAoB,GAAG,IAAI,GAAG,SAAS,GAAG,aAAa,CAAC;AAEpE;;;;;;;;GAQG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,oBAAoB,CAAC,CASpE"}

package/dist/offline/sync/sync-root.d.ts

@@ -0,0 +1,20 @@
+import type { OfflineRootKind } from "../types";
+/** How many record reads one root record's sync keeps in flight at once (after the root record). */
+export declare const SYNC_FETCH_CONCURRENCY = 4;
+/**
+ * Brings one root record's device copy up to date with the sync answer (C2): records changed since
+ * the stored server time are fetched (C3), records gone from the root record are deleted, the links
+ * are replaced, and artwork images are downloaded. The root record is fetched first; the other
+ * reads then run up to SYNC_FETCH_CONCURRENCY at a time. The sync state is stored only once every
+ * fetch succeeded (or answered 403/404); the first failure stops the sync before anything is
+ * written. A record with a waiting change is never overwritten.
+ */
+export declare function syncRoot(rootId: string, kind?: OfflineRootKind): Promise<void>;
+/**
+ * Syncs every root record of every kind (`listSyncRoots()` of the primary kind and of each
+ * `extraRootKinds` entry), then removes from the device the known root records no kind lists
+ * (unless they still have waiting changes). A kind whose list throws keeps its device copy
+ * unchanged; the primary kind's list throwing stops the sync. Does nothing offline.
+ */
+export declare function syncAll(): Promise<void>;
+//# sourceMappingURL=sync-root.d.ts.map

package/dist/offline/sync/sync-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-root.d.ts","sourceRoot":"","sources":["../../../src/offline/sync/sync-root.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAyChD,oGAAoG;AACpG,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAkExC;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA6OpF;AAED;;;;;GAKG;AACH,wBAAsB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CA0E7C"}

package/dist/offline/sync/waiting.d.ts

@@ -0,0 +1,15 @@
+import type { QueueEntry } from "../store/DeviceStore";
+export declare const recordKeyOf: (type: string, id: string) => string;
+/**
+ * The records a queue entry targets: its `recordType`/`recordId`, the `data.type`/`data.id` of
+ * its body (a record created on this device), and the `<type>/<id>` of its path (the last
+ * segment naming a synced type, when an id follows it: `npcs/n1`, `npcs/n1/merge`; a collection
+ * path such as `roots/C/npcs` targets no record).
+ */
+export declare function recordKeysOfEntry(entry: QueueEntry, typeNames: Set<string>): string[];
+/**
+ * Every record with a waiting change: targeted by a queue entry that is pending, sending, in
+ * conflict or failed. Such a record is never overwritten or deleted by a sync or a write-through.
+ */
+export declare function waitingRecordKeys(queue: QueueEntry[], typeNames: Set<string>): Set<string>;
+//# sourceMappingURL=waiting.d.ts.map

package/dist/offline/sync/waiting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"waiting.d.ts","sourceRoot":"","sources":["../../../src/offline/sync/waiting.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,EAAE,IAAI,MAAM,WAAoB,CAAC;AAEzE;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,CAmBrF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAI1F"}

package/dist/offline/types.d.ts

@@ -0,0 +1,159 @@
+import type { ApiRequestDataTypeInterface } from "../core/interfaces/ApiRequestDataTypeInterface";
+import type { DeviceStore, StoredRecord } from "./store/DeviceStore";
+/** Header of a request the server runs as an offline replay. Never answered locally. */
+export declare const OFFLINE_REPLAY_HEADER = "x-offline-replay";
+export type OfflineMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+/** A Module (matched by its endpoint), a ":param" capture, or a literal segment ("playing", "merge"). */
+export type PatternSegment = ApiRequestDataTypeInterface | string;
+/** `url` (beyond the contract, optional): the absolute URL the request was made to, for the `links` of a list. */
+export type OfflineRequest = {
+    method: OfflineMethod;
+    path: string;
+    query: URLSearchParams;
+    body?: any;
+    url?: string;
+};
+/** `body` is a JSON:API document, `undefined` for a 204. */
+export type OfflineAnswer = {
+    status: number;
+    body: any;
+};
+export type LocalAnswerContext = {
+    request: OfflineRequest;
+    params: Record<string, string>;
+    store: DeviceStore;
+};
+export type LocalAnswer = (ctx: LocalAnswerContext) => Promise<OfflineAnswer>;
+export type OfflineRoute = {
+    method: OfflineMethod;
+    pattern: PatternSegment[];
+    answer: LocalAnswer;
+    queue: boolean;
+};
+/**
+ * A type the API reads only as a list per target record: each changed record's target is the
+ * other end of its sync link of `linkKind` (from the record to the target), and `endpoint`
+ * builds that target's list path with `EndpointCreator`.
+ */
+export type OfflineLinkedListFetch = {
+    linkKind: string;
+    endpoint: (rootId: string, target: {
+        type: string;
+        id: string;
+    }) => string;
+};
+/** One more kind of root record beside `rootModule` (e.g. a notebook). Optional. */
+export type OfflineRootKind = {
+    /** The module of the root records of this kind. Sync reads `{module}/:rootId/sync`. */
+    module: ApiRequestDataTypeInterface;
+    /** The ids of the roots of this kind to keep on the device. Throw to keep the device copy unchanged. */
+    listSyncRoots: () => Promise<string[]>;
+    /**
+     * Per record type, the full list endpoint (query string included) that downloads every record of
+     * that type under one root of this kind, built from the stored root record. Replaces the type's
+     * `fetch` mode under this kind only. Never given `updatedSince`.
+     */
+    typeEndpoints?: {
+        module: ApiRequestDataTypeInterface;
+        endpoint: (root: {
+            id: string;
+            resource: StoredRecord["resource"];
+        }) => string;
+    }[];
+    /** The module whose model reads this kind's sync answer. Default: the library's `RootSync` module (`root-syncs`). */
+    syncModule?: ApiRequestDataTypeInterface;
+};
+type LocalWriteBase = {
+    store: DeviceStore;
+    module: ApiRequestDataTypeInterface;
+    id: string;
+};
+/** What a generic local write (`afterLocalWrite`) did, inside its transaction. */
+export type OfflineLocalWriteContext = (LocalWriteBase & {
+    method: "POST";
+    resource: StoredRecord["resource"];
+    previous: null;
+}) | (LocalWriteBase & {
+    method: "PUT" | "PATCH";
+    resource: StoredRecord["resource"];
+    previous: StoredRecord["resource"];
+}) | (LocalWriteBase & {
+    method: "DELETE";
+    resource: null;
+    previous: StoredRecord["resource"];
+});
+export type OfflineTypeConfig = {
+    module: ApiRequestDataTypeInterface;
+    /**
+     * How the sync fetches the type's changed records: the root record's list (`root-list`), one
+     * GET per record (`by-id`), or (`linked-list`) the list of each record's target, found through
+     * the sync answer's links of `linkedList.linkKind` (e.g. player notes, read per target only).
+     */
+    fetch: "root-list" | "by-id" | "linked-list";
+    /** Required with `fetch: "linked-list"`. */
+    linkedList?: OfflineLinkedListFetch;
+    readOnly: boolean;
+    serverOwnedFields: string[];
+    /**
+     * Relationship name → Neo4j relationship type (`faction` → `MEMBER_OF`). A link the device
+     * writes from a request's relationships carries the mapped type, the kind synced links carry;
+     * an unmapped name is stored as the name itself.
+     */
+    relationshipKinds?: Record<string, string>;
+    /** The string attributes the server's fulltext index covers (default: every string attribute). */
+    searchFields?: string[];
+    /** The server's order with no `orderBy` (default `updatedAt DESC`). */
+    defaultOrderBy?: string;
+    /**
+     * Called by the generic POST/PUT/PATCH/DELETE local answers inside the same transaction as the
+     * write and the enqueue (a throw rolls both back). Never called by sync or write-through.
+     */
+    afterLocalWrite?: (ctx: OfflineLocalWriteContext) => Promise<void>;
+};
+export type OfflineConfig = {
+    getUserId: () => string | undefined;
+    /**
+     * Offline mode is off on each device until the user turns it on (`turnOnOffline`), stored per
+     * user per device. Default (undefined/false): always on, every device keeps the copy.
+     */
+    requireOptIn?: boolean;
+    /** The module whose records own every other record (in Wyrdli, Modules.Campaign). */
+    rootModule: ApiRequestDataTypeInterface;
+    types: OfflineTypeConfig[];
+    routes: OfflineRoute[];
+    /** Ids of the root records to keep on the device. */
+    listSyncRoots: () => Promise<string[]>;
+    /** More kinds of root records beside `rootModule`, each synced and kept on its own (optional). */
+    extraRootKinds?: OfflineRootKind[];
+    shellPath: (locale: string) => string;
+    syncIntervalMs: number;
+    /**
+     * Where the device worker loads SQLite from at run time (default `/offline-sqlite/index.mjs`).
+     * SQLite is never bundled: its own helper worker uses a computed URL that app bundlers refuse.
+     * The app serves the files of `dist/offline/sqlite/` at this URL's folder.
+     */
+    sqliteModuleUrl?: string;
+    /**
+     * Where the device-copy worker is started from (default `/offline-sqlite/device-worker.mjs`).
+     * It is a standalone file in `dist/offline/sqlite/`, never bundled by the app.
+     */
+    deviceWorkerUrl?: string;
+};
+export declare const DEFAULT_SQLITE_MODULE_URL = "/offline-sqlite/index.mjs";
+export declare const DEVICE_WORKER_FILE = "device-worker.mjs";
+export declare const DEFAULT_DEVICE_WORKER_URL = "/offline-sqlite/device-worker.mjs";
+/**
+ * The files of `dist/offline/sqlite/` the app serves: the device worker and the SQLite files
+ * copied from @sqlite.org/sqlite-wasm.
+ */
+export declare const OFFLINE_SQLITE_FILES: readonly ["device-worker.mjs", "index.mjs", "sqlite3.wasm", "sqlite3-opfs-async-proxy.js"];
+/** Thrown by a local answer for something that only the server can do. Answered as a 503 "needs-connection". */
+export declare class NeedsConnectionError extends Error {
+    readonly status = 503;
+    readonly code = "needs-connection";
+    constructor(message?: string);
+}
+/** Segments joined with "/", modules by their endpoint. */
+export declare function patternToString(pattern: PatternSegment[]): string;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/offline/types.d.ts.map

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

package/dist/offline/write-through.d.ts

@@ -0,0 +1,12 @@
+import type { ApiData } from "../core/interfaces/ApiData";
+export type WriteThroughRequest = {
+    method: string;
+    url: string;
+};
+/**
+ * After a successful online write, copies the answer into the device copy so it is never behind
+ * the GM's own work: the resource and its `included` for POST/PUT/PATCH, the record removed for a
+ * DELETE. It never fails the request: a problem is logged and the next sync repairs the copy.
+ */
+export declare function writeThrough(request: WriteThroughRequest, response: ApiData): Promise<void>;
+//# sourceMappingURL=write-through.d.ts.map

package/dist/offline/write-through.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-through.d.ts","sourceRoot":"","sources":["../../src/offline/write-through.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAW1D,MAAM,MAAM,mBAAmB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AA2HlE;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAoDjG"}

package/dist/permissions/check.d.ts

@@ -0,0 +1,37 @@
+import { Action, ModuleWithPermissions, PermissionModule, PermissionUser } from "./types";
+/**
+ * Check if a user has permission to perform an action on a module.
+ *
+ * @param module - The module to check permissions for
+ * @param action - The action to check (read, create, update, delete)
+ * @param user - The user with their modules and permissions
+ * @param data - Optional data object for path-based permission checks
+ */
+export declare function checkPermissions<T extends PermissionUser>(params: {
+    module: ModuleWithPermissions;
+    action: Action;
+    user: T;
+    data?: any;
+}): boolean;
+/**
+ * Check permissions from server context where user object is not fully available.
+ *
+ * @param module - The module to check permissions for
+ * @param action - The action to check
+ * @param userId - The user's ID
+ * @param selectedModule - The selected module with its permissions
+ * @param data - Optional data object for path-based permission checks
+ */
+export declare function checkPermissionsFromServer(params: {
+    module: ModuleWithPermissions;
+    action: Action;
+    userId: string;
+    selectedModule?: PermissionModule;
+    data?: any;
+}): boolean;
+/**
+ * Traverse an object path and check if the value matches the user ID.
+ * Handles nested objects, arrays, and various data structures.
+ */
+export declare function getValueFromPath(obj: any, path: string, userId: string): any;
+//# sourceMappingURL=check.d.ts.map

package/dist/permissions/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/permissions/check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE1F;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,cAAc,EAAE,MAAM,EAAE;IACjE,MAAM,EAAE,qBAAqB,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,CAAC,CAAC;IACR,IAAI,CAAC,EAAE,GAAG,CAAC;CACZ,GAAG,OAAO,CAyBV;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE;IACjD,MAAM,EAAE,qBAAqB,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,gBAAgB,CAAC;IAClC,IAAI,CAAC,EAAE,GAAG,CAAC;CACZ,GAAG,OAAO,CAuBV;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,CAwC5E"}

package/dist/permissions/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./types";
+export * from "./check";
+//# sourceMappingURL=index.d.ts.map

package/dist/permissions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/permissions/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC"}

package/dist/permissions/types.d.ts

@@ -0,0 +1,100 @@
+import { LucideIcon } from "lucide-react";
+import { ApiRequestDataTypeInterface } from "../core/interfaces/ApiRequestDataTypeInterface";
+import { FieldSelector } from "../core/fields/FieldSelector";
+/**
+ * Permission actions
+ */
+export declare enum Action {
+    Read = "read",
+    Create = "create",
+    Update = "update",
+    Delete = "delete"
+}
+/**
+ * Generic permission check type.
+ * Can be a boolean or a function that checks permissions dynamically.
+ * @template T - The data type being checked
+ * @template U - The user type (defaults to PermissionUser)
+ */
+export type PermissionCheck<T, U = PermissionUser> = boolean | ((user?: U | string, data?: T) => boolean);
+/**
+ * Page URL configuration for modules
+ */
+export type PageUrl = {
+    pageUrl?: string;
+};
+/**
+ * Module permission definition wrapper
+ */
+export type ModulePermissionDefinition<T> = {
+    interface: T;
+};
+/**
+ * Base module definition
+ */
+export type ModuleDefinition = {
+    pageUrl?: string;
+    name: string;
+    model: any;
+    feature?: string;
+    moduleId?: string;
+};
+/**
+ * Permission configuration for a module.
+ * Can be a boolean (allow/deny all) or a string path for dynamic checks.
+ */
+export interface PermissionConfig {
+    create: boolean | string;
+    read: boolean | string;
+    update: boolean | string;
+    delete: boolean | string;
+}
+/**
+ * Generic interface for a module that has permissions.
+ * Apps should ensure their Module class implements this.
+ */
+export interface PermissionModule {
+    id: string;
+    permissions: PermissionConfig;
+}
+/**
+ * Generic interface for a user that has modules with permissions.
+ * Apps should ensure their User class implements this.
+ */
+export interface PermissionUser {
+    id: string;
+    modules: PermissionModule[];
+}
+/**
+ * Module definition with permissions - extends ApiRequestDataTypeInterface
+ */
+export type ModuleWithPermissions = ApiRequestDataTypeInterface & {
+    pageUrl?: string;
+    feature?: string;
+    moduleId?: string;
+    icon?: LucideIcon;
+    inclusions?: Record<string, {
+        types?: string[];
+        fields?: FieldSelector<any>[];
+        include?: string[];
+    }>;
+};
+/**
+ * Factory type for creating module definitions
+ */
+export type ModuleFactory = (params: {
+    pageUrl?: string;
+    name: string;
+    cache?: string | "days" | "default" | "hours" | "max" | "minutes" | "seconds" | "weeks";
+    model: any;
+    feature?: string;
+    moduleId?: string;
+    icon?: LucideIcon;
+    identifier?: string[];
+    inclusions?: Record<string, {
+        types?: string[];
+        fields?: FieldSelector<any>[];
+        include?: string[];
+    }>;
+}) => ModuleWithPermissions;
+//# sourceMappingURL=types.d.ts.map

package/dist/permissions/types.d.ts.map

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

package/dist/roles/config.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Role ID configuration interface
+ * Apps provide their role IDs via configureRoles()
+ */
+export interface RoleIdConfig {
+    Administrator: string;
+    CompanyAdministrator: string;
+    [key: string]: string;
+}
+/**
+ * Configure role IDs for the library
+ * Call this at app startup to provide role ID constants
+ *
+ * @example
+ * ```typescript
+ * import { configureRoles } from "@carlonicora/nextjs-jsonapi";
+ * import { RoleId } from "@phlow/shared";
+ *
+ * configureRoles(RoleId);
+ * ```
+ */
+export declare function configureRoles(roleId: RoleIdConfig): void;
+/**
+ * Get configured role IDs
+ * @throws Error if roles not configured
+ */
+export declare function getRoleId(): RoleIdConfig;
+/**
+ * Check if roles have been configured
+ */
+export declare function isRolesConfigured(): boolean;
+//# sourceMappingURL=config.d.ts.map

package/dist/roles/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/roles/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB;AAKD;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAEzD;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,YAAY,CAKxC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C"}

package/dist/roles/index.d.ts

@@ -0,0 +1,2 @@
+export { configureRoles, getRoleId, isRolesConfigured, type RoleIdConfig } from "./config";
+//# sourceMappingURL=index.d.ts.map

package/dist/roles/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/roles/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,iBAAiB,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC"}