@sixb/core 0.1.21 → 0.1.22

package/dist/storage/ai-usage/types.d.ts.map

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

package/dist/storage/ai-usage/usage.d.ts

@@ -1,4 +1,6 @@
 import type { AiModelCallUsage, AiModelCallUsageInput } from "./types";
+/** Every count a model call can report. */
+export declare const AI_USAGE_FIELDS: readonly ["inputTokens", "outputTokens", "uncachedInputTokens", "cacheReadInputTokens", "cacheWriteInputTokens", "textOutputTokens", "reasoningOutputTokens", "audioDurationMs", "imageOutputTokens", "audioOutputTokens", "outputImages", "inputCharacters"];
 /** Validate provider-neutral counts and derive total/reporting fields without inventing zeroes. */
 export declare function normalizeAiModelCallUsage(input: AiModelCallUsageInput): AiModelCallUsage;
 /**

package/dist/storage/ai-usage/usage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../../src/storage/ai-usage/usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA;AAetE,mGAAmG;AACnG,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,qBAAqB,GAAG,gBAAgB,CAoCxF;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,QAAQ,CAAC,qBAAqB,CAAC,GACtC,gBAAgB,CAclB"}
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../../src/storage/ai-usage/usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA;AAEtE,2CAA2C;AAC3C,eAAO,MAAM,eAAe,+PAalB,CAAA;AAKV,mGAAmG;AACnG,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,qBAAqB,GAAG,gBAAgB,CA4CxF;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,QAAQ,CAAC,qBAAqB,CAAC,GACtC,gBAAgB,CAclB"}

package/dist/storage/artifacts/errors.d.ts

@@ -1,8 +1,18 @@
-export type ArtifactStorageErrorCode = "artifact_exists" | "artifact_not_found" | "artifact_kind_mismatch";
+import type { Principal } from "../../auth";
+export type ArtifactStorageErrorCode = "artifact_exists" | "artifact_not_found" | "artifact_kind_mismatch" | "artifact_moved" | "artifact_state_full";
+/** The version an artifact had moved on to, and who published it, when a publish found it moved. */
+export interface ArtifactLatestVersion {
+    readonly version: number;
+    readonly author: Principal;
+}
 /** Error for artifact-storage invariants. Callers branch on `code` rather than message text. */
 export declare class ArtifactStorageError extends Error {
     readonly code: ArtifactStorageErrorCode;
+    /** With `artifact_moved`: the latest version, which the publish was not based on. */
+    readonly latest?: ArtifactLatestVersion | undefined;
     readonly name = "ArtifactStorageError";
-    constructor(code: ArtifactStorageErrorCode, message: string);
+    constructor(code: ArtifactStorageErrorCode, message: string, 
+    /** With `artifact_moved`: the latest version, which the publish was not based on. */
+    latest?: ArtifactLatestVersion | undefined);
 }
 //# sourceMappingURL=errors.d.ts.map

package/dist/storage/artifacts/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/storage/artifacts/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,wBAAwB,GAChC,iBAAiB,GACjB,oBAAoB,GACpB,wBAAwB,CAAA;AAE5B,gGAAgG;AAChG,qBAAa,oBAAqB,SAAQ,KAAK;IAI3C,QAAQ,CAAC,IAAI,EAAE,wBAAwB;IAHzC,QAAQ,CAAC,IAAI,0BAAyB;gBAG3B,IAAI,EAAE,wBAAwB,EACvC,OAAO,EAAE,MAAM;CAIlB"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/storage/artifacts/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAE3C,MAAM,MAAM,wBAAwB,GAChC,iBAAiB,GACjB,oBAAoB,GACpB,wBAAwB,GACxB,gBAAgB,GAChB,qBAAqB,CAAA;AAEzB,oGAAoG;AACpG,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;CAC3B;AAED,gGAAgG;AAChG,qBAAa,oBAAqB,SAAQ,KAAK;IAI3C,QAAQ,CAAC,IAAI,EAAE,wBAAwB;IAEvC,qFAAqF;IACrF,QAAQ,CAAC,MAAM,CAAC,EAAE,qBAAqB;IANzC,QAAQ,CAAC,IAAI,0BAAyB;gBAG3B,IAAI,EAAE,wBAAwB,EACvC,OAAO,EAAE,MAAM;IACf,qFAAqF;IAC5E,MAAM,CAAC,EAAE,qBAAqB,YAAA;CAI1C"}

package/dist/storage/artifacts/in-memory.d.ts

@@ -1,33 +1,54 @@
-import type { ArtifactFrameGrantRecord, ArtifactRecord, ArtifactStorage, ArtifactVersionRecord, CreateArtifactInput, DeleteArtifactInput, DeleteArtifactVersionsByOriginInput, DeleteExpiredArtifactFrameGrantsInput, FindArtifactFrameGrantInput, GetArtifactInput, GetArtifactVersionInput, ListArtifactsInput, ListArtifactsResult, ListArtifactVersionsInput, ListArtifactVersionsResult, ListReferencingVersionsInput, PublishArtifactVersionInput, PublishedArtifactVersion } from "./types";
+import type { ArtifactFrameGrantRecord, ArtifactRecord, ArtifactStateEntry, ArtifactStateKeyInput, ArtifactStateScope, ArtifactStorage, ArtifactVersionRecord, CopyArtifactInput, CreateArtifactInput, DeleteArtifactInput, DeleteArtifactVersionsByOriginInput, DeleteExpiredArtifactFrameGrantsInput, FindArtifactFrameGrantInput, GetArtifactInput, GetArtifactVersionInput, ListArtifactsInput, ListArtifactsResult, ListArtifactVersionsInput, ListArtifactVersionsResult, ListReferencingVersionsInput, PublishArtifactVersionInput, PublishedArtifactVersion, SetArtifactStateInput } from "./types";
 interface StoredArtifact {
     readonly record: ArtifactRecord;
     /** Oldest first. */
     readonly versions: readonly ArtifactVersionRecord[];
     /** The number the next version gets; it only grows, so a deleted number is never reused. */
     readonly nextVersion: number;
+    /** The threads it is shared in, by id. */
+    readonly threads: ReadonlyMap<string, ThreadLink>;
+}
+interface ThreadLink {
+    /** When it was first shared there. */
+    readonly sharedAt: Date;
+    /** Copied for the thread: shared there whatever versions it keeps. */
+    readonly copied: boolean;
 }
 interface InMemoryArtifactSnapshot {
     readonly artifacts: ReadonlyMap<string, StoredArtifact>;
     readonly frameGrants: ReadonlyMap<string, ArtifactFrameGrantRecord>;
+    readonly state: ReadonlyMap<string, ReadonlyMap<string, ArtifactStateEntry>>;
 }
 export declare class InMemoryArtifactStorage implements ArtifactStorage {
     private artifacts;
     private frameGrants;
+    /** By artifact and reader, then by key. */
+    private state;
     create(input: CreateArtifactInput): Promise<PublishedArtifactVersion>;
     publish(input: PublishArtifactVersionInput): Promise<PublishedArtifactVersion>;
     get(input: GetArtifactInput): Promise<ArtifactRecord | null>;
     list(input: ListArtifactsInput): Promise<ListArtifactsResult>;
     getVersion(input: GetArtifactVersionInput): Promise<ArtifactVersionRecord | null>;
     listVersions(input: ListArtifactVersionsInput): Promise<ListArtifactVersionsResult>;
+    listThreadIds(input: GetArtifactInput): Promise<string[]>;
+    copy(input: CopyArtifactInput): Promise<ArtifactRecord>;
     listReferencingVersions(input: ListReferencingVersionsInput): Promise<ArtifactVersionRecord[]>;
     createFrameGrant(record: ArtifactFrameGrantRecord): Promise<void>;
     findFrameGrant(input: FindArtifactFrameGrantInput): Promise<ArtifactFrameGrantRecord | null>;
     deleteExpiredFrameGrants(input: DeleteExpiredArtifactFrameGrantsInput): Promise<number>;
+    getState(input: ArtifactStateKeyInput): Promise<ArtifactStateEntry | null>;
+    setState(input: SetArtifactStateInput): Promise<void>;
+    deleteState(input: ArtifactStateKeyInput): Promise<boolean>;
+    listState(input: ArtifactStateScope): Promise<ArtifactStateEntry[]>;
+    clearState(input: ArtifactStateScope): Promise<number>;
     delete(input: DeleteArtifactInput): Promise<boolean>;
     deleteVersionsByOrigin(input: DeleteArtifactVersionsByOriginInput): Promise<number>;
     snapshot(): InMemoryArtifactSnapshot;
     restore(snapshot: InMemoryArtifactSnapshot): void;
-    /** Deletes an artifact with its frame grants, as the SQL providers' cascade does. */
+    /**
+     * Deletes an artifact with its frame grants and what it keeps for its readers, as the SQL
+     * providers' cascade does.
+     */
     private deleteArtifact;
 }
 export {};

package/dist/storage/artifacts/in-memory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"in-memory.d.ts","sourceRoot":"","sources":["../../../src/storage/artifacts/in-memory.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,wBAAwB,EACxB,cAAc,EACd,eAAe,EAEf,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,mCAAmC,EACnC,qCAAqC,EACrC,2BAA2B,EAC3B,gBAAgB,EAChB,uBAAuB,EACvB,kBAAkB,EAClB,mBAAmB,EACnB,yBAAyB,EACzB,0BAA0B,EAC1B,4BAA4B,EAC5B,2BAA2B,EAC3B,wBAAwB,EACzB,MAAM,SAAS,CAAA;AAEhB,UAAU,cAAc;IACtB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,oBAAoB;IACpB,QAAQ,CAAC,QAAQ,EAAE,SAAS,qBAAqB,EAAE,CAAA;IACnD,4FAA4F;IAC5F,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAC7B;AAED,UAAU,wBAAwB;IAChC,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;IACvD,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAA;CACpE;AAED,qBAAa,uBAAwB,YAAW,eAAe;IAC7D,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,WAAW,CAA8C;IAE3D,MAAM,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAkBrE,OAAO,CAAC,KAAK,EAAE,2BAA2B,GAAG,OAAO,CAAC,wBAAwB,CAAC;IA2B9E,GAAG,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAK5D,IAAI,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAmB7D,UAAU,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IAMjF,YAAY,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAOnF,uBAAuB,CAC3B,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAgB7B,gBAAgB,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IAOjE,cAAc,CAClB,KAAK,EAAE,2BAA2B,GACjC,OAAO,CAAC,wBAAwB,GAAG,IAAI,CAAC;IAKrC,wBAAwB,CAAC,KAAK,EAAE,qCAAqC,GAAG,OAAO,CAAC,MAAM,CAAC;IAWvF,MAAM,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IAIpD,sBAAsB,CAAC,KAAK,EAAE,mCAAmC,GAAG,OAAO,CAAC,MAAM,CAAC;IA0BzF,QAAQ,IAAI,wBAAwB;IAIpC,OAAO,CAAC,QAAQ,EAAE,wBAAwB,GAAG,IAAI;IAMjD,qFAAqF;IACrF,OAAO,CAAC,cAAc;CAMvB"}
+{"version":3,"file":"in-memory.d.ts","sourceRoot":"","sources":["../../../src/storage/artifacts/in-memory.ts"],"names":[],"mappings":"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"}

package/dist/storage/artifacts/index.d.ts

@@ -1,5 +1,5 @@
-export type { ArtifactStorageErrorCode } from "./errors";
+export type { ArtifactLatestVersion, ArtifactStorageErrorCode } from "./errors";
 export { ArtifactStorageError } from "./errors";
 export { InMemoryArtifactStorage } from "./in-memory";
-export type { ArtifactFile, ArtifactFrameGrantRecord, ArtifactFrameTarget, ArtifactKind, ArtifactOrigin, ArtifactOutline, ArtifactRecord, ArtifactReference, ArtifactStorage, ArtifactVersionInput, ArtifactVersionRecord, CreateArtifactInput, DeleteArtifactInput, DeleteArtifactVersionsByOriginInput, DeleteExpiredArtifactFrameGrantsInput, FindArtifactFrameGrantInput, GetArtifactInput, GetArtifactVersionInput, ListArtifactsInput, ListArtifactsResult, ListArtifactVersionsInput, ListArtifactVersionsResult, ListReferencingVersionsInput, PublishArtifactVersionInput, PublishedArtifactVersion, } from "./types";
+export type { ArtifactFile, ArtifactFrameGrantRecord, ArtifactFrameTarget, ArtifactKind, ArtifactOrigin, ArtifactOutline, ArtifactRecord, ArtifactReference, ArtifactStateEntry, ArtifactStateKeyInput, ArtifactStateScope, ArtifactStorage, ArtifactVersionInput, ArtifactVersionRecord, CopyArtifactInput, CreateArtifactInput, DeleteArtifactInput, DeleteArtifactVersionsByOriginInput, DeleteExpiredArtifactFrameGrantsInput, FindArtifactFrameGrantInput, GetArtifactInput, GetArtifactVersionInput, ListArtifactsInput, ListArtifactsResult, ListArtifactVersionsInput, ListArtifactVersionsResult, ListReferencingVersionsInput, PublishArtifactVersionInput, PublishedArtifactVersion, SetArtifactStateInput, } from "./types";
 //# sourceMappingURL=index.d.ts.map

package/dist/storage/artifacts/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/storage/artifacts/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAA;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA;AAC/C,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AACrD,YAAY,EACV,YAAY,EACZ,wBAAwB,EACxB,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,mCAAmC,EACnC,qCAAqC,EACrC,2BAA2B,EAC3B,gBAAgB,EAChB,uBAAuB,EACvB,kBAAkB,EAClB,mBAAmB,EACnB,yBAAyB,EACzB,0BAA0B,EAC1B,4BAA4B,EAC5B,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/storage/artifacts/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAA;AAC/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA;AAC/C,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AACrD,YAAY,EACV,YAAY,EACZ,wBAAwB,EACxB,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,mCAAmC,EACnC,qCAAqC,EACrC,2BAA2B,EAC3B,gBAAgB,EAChB,uBAAuB,EACvB,kBAAkB,EAClB,mBAAmB,EACnB,yBAAyB,EACzB,0BAA0B,EAC1B,4BAA4B,EAC5B,2BAA2B,EAC3B,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,SAAS,CAAA"}

package/dist/storage/artifacts/record.d.ts

@@ -1,5 +1,5 @@
-import { ArtifactStorageError } from "./errors";
-import type { ArtifactFrameGrantRecord, ArtifactKind, ArtifactRecord, ArtifactVersionRecord } from "./types";
+import { type ArtifactLatestVersion, ArtifactStorageError } from "./errors";
+import type { ArtifactFrameGrantRecord, ArtifactKind, ArtifactRecord, ArtifactStateEntry, ArtifactVersionRecord } from "./types";
 type Row = {
     readonly [column: string]: unknown;
 };
@@ -7,11 +7,28 @@ export declare function parseArtifactRow(row: Row): ArtifactRecord;
 export declare function parseArtifactVersionRow(row: Row): ArtifactVersionRecord;
 /** Targets are checked one by one: they decide what a frame may show from other artifacts. */
 export declare function parseArtifactFrameGrantRow(row: Row): ArtifactFrameGrantRecord;
+export declare function parseArtifactStateRow(row: Row): ArtifactStateEntry;
+/** A value's UTF-8 bytes, which a reader's state limits count. */
+export declare function artifactStateBytes(value: string): number;
+/**
+ * Throws `artifact_state_full` when a value would take a reader past `ARTIFACT_STATE_LIMITS`.
+ * `others` is what the reader keeps under every other key, so replacing a value counts once.
+ */
+export declare function checkArtifactStateWrite(input: {
+    readonly key: string;
+    readonly valueBytes: number;
+    readonly others: {
+        readonly keys: number;
+        readonly bytes: number;
+    };
+}): void;
 /** The errors every provider raises, with one wording. */
 export declare const artifactStorageErrors: {
     exists: (id: string) => ArtifactStorageError;
     notFound: (id: string) => ArtifactStorageError;
     kindMismatch: (id: string, kind: ArtifactKind, requested: ArtifactKind) => ArtifactStorageError;
+    moved: (id: string, baseVersion: number, latest: ArtifactLatestVersion) => ArtifactStorageError;
+    stateFull: (message: string) => ArtifactStorageError;
 };
 export {};
 //# sourceMappingURL=record.d.ts.map

package/dist/storage/artifacts/record.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../../src/storage/artifacts/record.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA;AAC/C,OAAO,KAAK,EAEV,wBAAwB,EAExB,YAAY,EACZ,cAAc,EACd,qBAAqB,EACtB,MAAM,SAAS,CAAA;AAMhB,KAAK,GAAG,GAAG;IAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAA;AAEjD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,GAAG,GAAG,cAAc,CAezD;AAED,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,GAAG,GAAG,qBAAqB,CA6BvE;AAED,8FAA8F;AAC9F,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,GAAG,GAAG,wBAAwB,CAY7E;AAED,0DAA0D;AAC1D,eAAO,MAAM,qBAAqB;iBACnB,MAAM;mBAEJ,MAAM;uBAEF,MAAM,QAAQ,YAAY,aAAa,YAAY;CAKvE,CAAA"}
+{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../../src/storage/artifacts/record.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA;AAC3E,OAAO,KAAK,EAEV,wBAAwB,EAExB,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACtB,MAAM,SAAS,CAAA;AAMhB,KAAK,GAAG,GAAG;IAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAA;AAEjD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,GAAG,GAAG,cAAc,CAezD;AAED,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,GAAG,GAAG,qBAAqB,CA6BvE;AAED,8FAA8F;AAC9F,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,GAAG,GAAG,wBAAwB,CAY7E;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,GAAG,GAAG,kBAAkB,CAalE;AAED,kEAAkE;AAClE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;CACnE,GAAG,IAAI,CAiBP;AAMD,0DAA0D;AAC1D,eAAO,MAAM,qBAAqB;iBACnB,MAAM;mBAEJ,MAAM;uBAEF,MAAM,QAAQ,YAAY,aAAa,YAAY;gBAK1D,MAAM,eAAe,MAAM,UAAU,qBAAqB;yBAMjD,MAAM;CAC5B,CAAA"}

package/dist/storage/artifacts/types.d.ts

@@ -24,7 +24,10 @@ export interface ArtifactFile {
     readonly path: string;
     readonly file: FileRef;
 }
-/** Where a version was published from. Provenance only: reading never depends on it. */
+/**
+ * Where a version was published from: an Agent turn in a thread. Publishing one shares the artifact
+ * in that thread.
+ */
 export interface ArtifactOrigin {
     readonly threadId: string;
     readonly runId: string;
@@ -61,6 +64,11 @@ export interface PublishArtifactVersionInput {
     /** Must be the artifact's kind. */
     readonly kind: ArtifactKind;
     readonly version: ArtifactVersionInput;
+    /**
+     * The version this one was made from. When the latest version is another, the publish fails
+     * with `artifact_moved` rather than replace changes it never saw.
+     */
+    readonly baseVersion?: number;
 }
 export interface PublishedArtifactVersion {
     readonly artifact: ArtifactRecord;
@@ -73,8 +81,8 @@ export interface GetArtifactInput {
 export interface ListArtifactsInput {
     readonly projectId: string;
     readonly owner?: Principal;
-    /** Only artifacts with a version published from this thread. */
-    readonly originThreadId?: string;
+    /** Only artifacts shared in this thread. */
+    readonly threadId?: string;
     /** Only artifacts of this kind. */
     readonly kind?: ArtifactKind;
     readonly limit?: number;
@@ -105,6 +113,18 @@ export interface DeleteArtifactInput {
     readonly projectId: string;
     readonly id: string;
 }
+export interface CopyArtifactInput {
+    readonly projectId: string;
+    /** The artifact copied. */
+    readonly sourceId: string;
+    /** The copy's id. */
+    readonly id: string;
+    /** Owns the copy. */
+    readonly owner: Principal;
+    /** The thread the copy is shared in, as long as it lasts: a fork's. */
+    readonly threadId: string;
+    readonly copiedAt?: Date;
+}
 export interface ListReferencingVersionsInput {
     readonly projectId: string;
     /** The artifact the versions refer to. */
@@ -144,16 +164,45 @@ export interface DeleteArtifactVersionsByOriginInput {
     readonly projectId: string;
     readonly runId: string;
 }
+/** Whose values, kept by which artifact: a page keeps its own for each reader. */
+export interface ArtifactStateScope {
+    readonly projectId: string;
+    readonly artifactId: string;
+    readonly principal: Principal;
+}
+export interface ArtifactStateKeyInput extends ArtifactStateScope {
+    readonly key: string;
+}
+export interface SetArtifactStateInput extends ArtifactStateKeyInput {
+    /** JSON text, stored as written. */
+    readonly value: string;
+    readonly updatedAt: Date;
+}
+/** One value a page keeps for a reader. */
+export interface ArtifactStateEntry {
+    readonly key: string;
+    /** JSON text. */
+    readonly value: string;
+    /** The value's UTF-8 bytes, which the reader's limits count. */
+    readonly sizeBytes: number;
+    readonly updatedAt: Date;
+}
 /**
  * Persistence only: who may read or publish, and what a version may contain, are decided in Core
  * before a call reaches storage.
  */
 export interface ArtifactStorage {
-    /** Creates the artifact with its first version. Throws `artifact_exists` when the id is taken. */
+    /**
+     * Creates the artifact with its first version, shared in its origin's thread. Throws
+     * `artifact_exists` when the id is taken.
+     */
     create(input: CreateArtifactInput): Promise<PublishedArtifactVersion>;
     /**
-     * Stores the next version and makes it the latest. Throws `artifact_not_found` or
-     * `artifact_kind_mismatch`. A version number is never reused, even after its version is deleted.
+     * Stores the next version and makes it the latest, sharing the artifact in its origin's thread.
+     * Throws `artifact_not_found`, `artifact_kind_mismatch`, or `artifact_moved` with the latest version and its author when
+     * `baseVersion` is not the latest, checked in the same transaction as the write, so of two
+     * publishes from one base only the first is stored. A version number is never reused, even
+     * after its version is deleted.
      */
     publish(input: PublishArtifactVersionInput): Promise<PublishedArtifactVersion>;
     get(input: GetArtifactInput): Promise<ArtifactRecord | null>;
@@ -162,6 +211,18 @@ export interface ArtifactStorage {
     getVersion(input: GetArtifactVersionInput): Promise<ArtifactVersionRecord | null>;
     /** Newest first. */
     listVersions(input: ListArtifactVersionsInput): Promise<ListArtifactVersionsResult>;
+    /**
+     * The threads the artifact is shared in, by id: each one a version it keeps was published from,
+     * and the one it was copied for.
+     */
+    listThreadIds(input: GetArtifactInput): Promise<string[]>;
+    /**
+     * Copies an artifact with every version under its number, each without its origin, as a new
+     * artifact shared in `threadId` for as long as it lasts: a fork's copy, whose `@N` addresses
+     * still resolve. The files are reused, not copied. Throws `artifact_not_found` without the
+     * source and `artifact_exists` when the id is taken.
+     */
+    copy(input: CopyArtifactInput): Promise<ArtifactRecord>;
     /**
      * The latest version of each artifact whose latest version has an address to this artifact, so
      * a new version can tell which artifacts it breaks. Ordered by artifact id.
@@ -173,11 +234,29 @@ export interface ArtifactStorage {
     findFrameGrant(input: FindArtifactFrameGrantInput): Promise<ArtifactFrameGrantRecord | null>;
     /** Deletes up to `limit` grants that expired before `expiredBefore`, and returns the count. */
     deleteExpiredFrameGrants(input: DeleteExpiredArtifactFrameGrantsInput): Promise<number>;
-    /** Deletes the artifact, every version, and its frame grants. `false` when it does not exist. */
+    /** A value a page keeps for a reader, or null when it keeps none under the key. */
+    getState(input: ArtifactStateKeyInput): Promise<ArtifactStateEntry | null>;
+    /**
+     * Keeps a value under its key, replacing one there. Throws `artifact_not_found`, or
+     * `artifact_state_full` when the value, or the reader's keys or bytes with it, would pass
+     * `ARTIFACT_STATE_LIMITS`, checked in the same transaction as the write.
+     */
+    setState(input: SetArtifactStateInput): Promise<void>;
+    /** `false` when there was no value under the key. */
+    deleteState(input: ArtifactStateKeyInput): Promise<boolean>;
+    /** Every value a page keeps for a reader, by key. */
+    listState(input: ArtifactStateScope): Promise<ArtifactStateEntry[]>;
+    /** Deletes every value a page keeps for a reader, and returns how many. */
+    clearState(input: ArtifactStateScope): Promise<number>;
+    /**
+     * Deletes the artifact, every version, its frame grants, and what it keeps for its readers.
+     * `false` when it does not exist.
+     */
     delete(input: DeleteArtifactInput): Promise<boolean>;
     /**
      * Deletes the versions a run published and returns how many. An artifact left without versions
-     * is deleted; one that lost its latest version points at its newest remaining one.
+     * is deleted; one that lost its latest version points at its newest remaining one. One left
+     * without a version from the run's thread is no longer shared there, unless it was copied for it.
      */
     deleteVersionsByOrigin(input: DeleteArtifactVersionsByOriginInput): Promise<number>;
 }

package/dist/storage/artifacts/types.d.ts.map

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

package/dist/storage/auth/in-memory/auth-storage.d.ts

@@ -1,4 +1,4 @@
-import type { AuthStorage, CompleteDeviceAuthorizationInput, CompleteDeviceAuthorizationResult, CompleteMagicLinkSignInInput, CompleteOidcSignInInput, CompleteSignInResult, SuspendUserAndRevokeSessionsInput, UserRecord } from "../types";
+import type { AuthStorage, CompleteDeviceAuthorizationInput, CompleteDeviceAuthorizationResult, CompleteMagicLinkSignInInput, CompleteOidcSignInInput, CompleteSignInResult, SuspendUserAndRevokeSessionsInput, UpdateAuthUserResult } from "../types";
 import { InMemoryAuthAccessTokenStore } from "./access-tokens";
 import { InMemoryAuthDeviceAuthorizationStore } from "./device-authorizations";
 import { InMemoryAuthGroupMembershipStore } from "./group-memberships";
@@ -29,7 +29,8 @@ export declare class InMemoryAuthStorage implements AuthStorage {
     completeDeviceAuthorization(input: CompleteDeviceAuthorizationInput): Promise<CompleteDeviceAuthorizationResult>;
     completeMagicLinkSignIn(input: CompleteMagicLinkSignInInput): Promise<CompleteSignInResult>;
     completeOidcSignIn(input: CompleteOidcSignInInput): Promise<CompleteSignInResult>;
-    suspendUserAndRevokeSessions(input: SuspendUserAndRevokeSessionsInput): Promise<UserRecord>;
+    suspendUserAndRevokeSessions(input: SuspendUserAndRevokeSessionsInput): Promise<UpdateAuthUserResult>;
+    private refreshProviderProfile;
     private acceptInvitationAndApplyGroups;
     private applyGroups;
     private syncDirectoryGroups;

package/dist/storage/auth/in-memory/auth-storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth-storage.d.ts","sourceRoot":"","sources":["../../../../src/storage/auth/in-memory/auth-storage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EACX,gCAAgC,EAChC,iCAAiC,EACjC,4BAA4B,EAC5B,uBAAuB,EACvB,oBAAoB,EAKpB,iCAAiC,EAEjC,UAAU,EACX,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAA;AAC9D,OAAO,EAAE,oCAAoC,EAAE,MAAM,yBAAyB,CAAA;AAC9E,OAAO,EAAE,gCAAgC,EAAE,MAAM,qBAAqB,CAAA;AACtE,OAAO,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAA;AAC5D,OAAO,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAA;AAC3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAA;AAC1D,OAAO,EAAE,yCAAyC,EAAE,MAAM,iBAAiB,CAAA;AAC3E,OAAO,EAAE,8CAA8C,EAAE,MAAM,qCAAqC,CAAA;AACpG,OAAO,EAAE,+BAA+B,EAAE,MAAM,oBAAoB,CAAA;AACpE,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAA;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAyBhD,OAAO,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA;AAE/C,qBAAa,mBAAoB,YAAW,WAAW;IACrD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6C;IAEnE,QAAQ,CAAC,KAAK,wBAAwC;IACtD,QAAQ,CAAC,UAAU,gCAAgD;IACnE,QAAQ,CAAC,eAAe,kCAAkD;IAC1E,QAAQ,CAAC,8BAA8B,iDAEtC;IACD,QAAQ,CAAC,QAAQ,2BAA2C;IAC5D,QAAQ,CAAC,YAAY,+BAA+C;IACpE,QAAQ,CAAC,WAAW,8BAA8C;IAClE,QAAQ,CAAC,gBAAgB,mCAAmD;IAC5E,QAAQ,CAAC,UAAU,6BAA6C;IAChE,QAAQ,CAAC,yBAAyB,4CAA4D;IAC9F,QAAQ,CAAC,oBAAoB,uCAAuD;IAEpF,QAAQ,IAAI,2BAA2B;IAgBvC,OAAO,CAAC,QAAQ,EAAE,2BAA2B,GAAG,IAAI;IAc9C,2BAA2B,CAC/B,KAAK,EAAE,gCAAgC,GACtC,OAAO,CAAC,iCAAiC,CAAC;IAyDvC,uBAAuB,CAC3B,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC,oBAAoB,CAAC;IA+H1B,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAiJjF,4BAA4B,CAChC,KAAK,EAAE,iCAAiC,GACvC,OAAO,CAAC,UAAU,CAAC;IAsBtB,OAAO,CAAC,8BAA8B;IAqCtC,OAAO,CAAC,WAAW;IAwBnB,OAAO,CAAC,mBAAmB;IA0B3B,OAAO,CAAC,mBAAmB;IAoB3B,OAAO,CAAC,kBAAkB;CAY3B;AAED,MAAM,MAAM,2BAA2B,GAAG,gBAAgB,CAAA"}
+{"version":3,"file":"auth-storage.d.ts","sourceRoot":"","sources":["../../../../src/storage/auth/in-memory/auth-storage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EACX,gCAAgC,EAChC,iCAAiC,EACjC,4BAA4B,EAC5B,uBAAuB,EACvB,oBAAoB,EAKpB,iCAAiC,EACjC,oBAAoB,EAGrB,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAA;AAC9D,OAAO,EAAE,oCAAoC,EAAE,MAAM,yBAAyB,CAAA;AAC9E,OAAO,EAAE,gCAAgC,EAAE,MAAM,qBAAqB,CAAA;AACtE,OAAO,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAA;AAC5D,OAAO,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAA;AAC3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAA;AAC1D,OAAO,EAAE,yCAAyC,EAAE,MAAM,iBAAiB,CAAA;AAC3E,OAAO,EAAE,8CAA8C,EAAE,MAAM,qCAAqC,CAAA;AACpG,OAAO,EAAE,+BAA+B,EAAE,MAAM,oBAAoB,CAAA;AACpE,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAA;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAyBhD,OAAO,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA;AAE/C,qBAAa,mBAAoB,YAAW,WAAW;IACrD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6C;IAEnE,QAAQ,CAAC,KAAK,wBAAwC;IACtD,QAAQ,CAAC,UAAU,gCAAgD;IACnE,QAAQ,CAAC,eAAe,kCAAkD;IAC1E,QAAQ,CAAC,8BAA8B,iDAEtC;IACD,QAAQ,CAAC,QAAQ,2BAA2C;IAC5D,QAAQ,CAAC,YAAY,+BAA+C;IACpE,QAAQ,CAAC,WAAW,8BAA8C;IAClE,QAAQ,CAAC,gBAAgB,mCAAmD;IAC5E,QAAQ,CAAC,UAAU,6BAA6C;IAChE,QAAQ,CAAC,yBAAyB,4CAA4D;IAC9F,QAAQ,CAAC,oBAAoB,uCAAuD;IAEpF,QAAQ,IAAI,2BAA2B;IAgBvC,OAAO,CAAC,QAAQ,EAAE,2BAA2B,GAAG,IAAI;IAc9C,2BAA2B,CAC/B,KAAK,EAAE,gCAAgC,GACtC,OAAO,CAAC,iCAAiC,CAAC;IAyDvC,uBAAuB,CAC3B,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC,oBAAoB,CAAC;IAiI1B,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAqJjF,4BAA4B,CAChC,KAAK,EAAE,iCAAiC,GACvC,OAAO,CAAC,oBAAoB,CAAC;IAwBhC,OAAO,CAAC,sBAAsB;IAgB9B,OAAO,CAAC,8BAA8B;IAqCtC,OAAO,CAAC,WAAW;IAwBnB,OAAO,CAAC,mBAAmB;IA0B3B,OAAO,CAAC,mBAAmB;IAoB3B,OAAO,CAAC,kBAAkB;CAY3B;AAED,MAAM,MAAM,2BAA2B,GAAG,gBAAgB,CAAA"}

package/dist/storage/auth/in-memory/users.d.ts

@@ -1,4 +1,4 @@
-import type { AuthUserStore, CreateAuthUserInput, ListAuthUsersInput, ListAuthUsersResult, UpdateAuthUserProfileInput, UpdateAuthUserStatusInput, UserRecord } from "../types";
+import type { AuthUserStore, CreateAuthUserInput, ListAuthUsersInput, ListAuthUsersResult, UpdateAuthUserProfileInput, UpdateAuthUserResult, UpdateAuthUserStatusInput, UserRecord } from "../types";
 import type { AuthStorageState } from "./shared";
 export declare class InMemoryAuthUserStore implements AuthUserStore {
     private readonly state;
@@ -8,12 +8,16 @@ export declare class InMemoryAuthUserStore implements AuthUserStore {
         readonly projectId: string;
         readonly id: string;
     }): Promise<UserRecord | null>;
+    getByIds(params: {
+        readonly projectId: string;
+        readonly ids: readonly string[];
+    }): Promise<readonly UserRecord[]>;
     getByEmail(params: {
         readonly projectId: string;
         readonly email: string;
     }): Promise<UserRecord | null>;
-    updateProfile(input: UpdateAuthUserProfileInput): Promise<UserRecord>;
-    updateStatus(input: UpdateAuthUserStatusInput): Promise<UserRecord>;
+    updateProfile(input: UpdateAuthUserProfileInput): Promise<UpdateAuthUserResult>;
+    updateStatus(input: UpdateAuthUserStatusInput): Promise<UpdateAuthUserResult>;
     list(input: ListAuthUsersInput): Promise<ListAuthUsersResult>;
 }
 //# sourceMappingURL=users.d.ts.map

package/dist/storage/auth/in-memory/users.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../../../../src/storage/auth/in-memory/users.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,0BAA0B,EAC1B,yBAAyB,EACzB,UAAU,EACX,MAAM,UAAU,CAAA;AACjB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAahD,qBAAa,qBAAsB,YAAW,aAAa;IAC7C,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,gBAAgB;IAE9C,MAAM,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC;IAoCvD,OAAO,CAAC,MAAM,EAAE;QACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;QAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;KACpB,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAKxB,UAAU,CAAC,MAAM,EAAE;QACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;QAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KACvB,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAIxB,aAAa,CAAC,KAAK,EAAE,0BAA0B,GAAG,OAAO,CAAC,UAAU,CAAC;IAqBrE,YAAY,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,UAAU,CAAC;IAoBnE,IAAI,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAmBpE"}
+{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../../../../src/storage/auth/in-memory/users.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,0BAA0B,EAC1B,oBAAoB,EACpB,yBAAyB,EACzB,UAAU,EACX,MAAM,UAAU,CAAA;AACjB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAahD,qBAAa,qBAAsB,YAAW,aAAa;IAC7C,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,gBAAgB;IAE9C,MAAM,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC;IAoCvD,OAAO,CAAC,MAAM,EAAE;QACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;QAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;KACpB,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAKxB,QAAQ,CAAC,MAAM,EAAE;QACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;QAC1B,QAAQ,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,CAAA;KAChC,GAAG,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC;IAO5B,UAAU,CAAC,MAAM,EAAE;QACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;QAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KACvB,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAIxB,aAAa,CAAC,KAAK,EAAE,0BAA0B,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA2B/E,YAAY,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAoB7E,IAAI,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAqBpE"}

package/dist/storage/auth/index.d.ts

@@ -1,6 +1,6 @@
 export type { AuthStorageErrorCode } from "./errors";
 export { AuthStorageError } from "./errors";
 export { InMemoryAuthStorage } from "./in-memory";
-export type { AccessTokenRecord, AuthAccessTokenStore, AuthDeviceAuthorizationStore, AuthGroupMembershipStore, AuthInvitationStore, AuthMagicLinkStore, AuthOidcAuthorizationAttemptStore, AuthServiceAccountGroupMembershipStore, AuthServiceAccountStore, AuthSessionStore, AuthStorage, AuthUserIdentityStore, AuthUserStore, BearerSessionState, CompleteAuthSessionInput, CompleteDeviceAuthorizationInput, CompleteDeviceAuthorizationResult, CompleteMagicLinkSignInInput, CompleteOidcSignInInput, CompleteSignInResult, CreateAuthAccessTokenInput, CreateAuthMagicLinkInput, CreateAuthServiceAccountInput, CreateAuthSessionInput, CreateAuthUserInput, CreateDeviceAuthorizationInput, CreateOidcAuthorizationAttemptInput, CreateOrUpdateAuthInvitationInput, DeviceAuthorizationRecord, DeviceAuthorizationStatus, GroupMembershipRecord, GroupMembershipSource, InvitationRecord, InvitationStatus, ListAuthAccessTokensInput, ListAuthAccessTokensResult, ListAuthInvitationsInput, ListAuthInvitationsResult, ListAuthServiceAccountsInput, ListAuthServiceAccountsResult, ListAuthSessionsInput, ListAuthSessionsResult, ListAuthUsersInput, ListAuthUsersResult, MagicLinkRecord, OidcAuthorizationAttemptRecord, ReconcileAuthServiceAccountGroupMembershipsInput, RotateSessionRefreshTokenResult, ServiceAccountGroupMembershipRecord, ServiceAccountRecord, ServiceAccountStatus, SessionRecord, SuspendUserAndRevokeSessionsInput, UpdateAuthServiceAccountInput, UpdateAuthUserProfileInput, UpdateAuthUserStatusInput, UpsertAuthGroupMembershipInput, UpsertAuthServiceAccountGroupMembershipInput, UpsertAuthUserIdentityInput, UserIdentityRecord, UserRecord, UserStatus, } from "./types";
+export type { AccessTokenRecord, AuthAccessTokenStore, AuthDeviceAuthorizationStore, AuthGroupMembershipStore, AuthInvitationStore, AuthMagicLinkStore, AuthOidcAuthorizationAttemptStore, AuthServiceAccountGroupMembershipStore, AuthServiceAccountStore, AuthSessionStore, AuthStorage, AuthUserIdentityStore, AuthUserStore, BearerSessionState, CompleteAuthSessionInput, CompleteDeviceAuthorizationInput, CompleteDeviceAuthorizationResult, CompleteMagicLinkSignInInput, CompleteOidcSignInInput, CompleteSignInResult, CreateAuthAccessTokenInput, CreateAuthMagicLinkInput, CreateAuthServiceAccountInput, CreateAuthSessionInput, CreateAuthUserInput, CreateDeviceAuthorizationInput, CreateOidcAuthorizationAttemptInput, CreateOrUpdateAuthInvitationInput, DeviceAuthorizationRecord, DeviceAuthorizationStatus, GroupMembershipRecord, GroupMembershipSource, InvitationRecord, InvitationStatus, ListAuthAccessTokensInput, ListAuthAccessTokensResult, ListAuthInvitationsInput, ListAuthInvitationsResult, ListAuthServiceAccountsInput, ListAuthServiceAccountsResult, ListAuthSessionsInput, ListAuthSessionsResult, ListAuthUsersInput, ListAuthUsersResult, MagicLinkRecord, OidcAuthorizationAttemptRecord, ReconcileAuthServiceAccountGroupMembershipsInput, RotateSessionRefreshTokenResult, ServiceAccountGroupMembershipRecord, ServiceAccountRecord, ServiceAccountStatus, SessionRecord, SuspendUserAndRevokeSessionsInput, UpdateAuthServiceAccountInput, UpdateAuthUserProfileInput, UpdateAuthUserResult, UpdateAuthUserStatusInput, UpsertAuthGroupMembershipInput, UpsertAuthServiceAccountGroupMembershipInput, UpsertAuthUserIdentityInput, UserIdentityRecord, UserRecord, UserStatus, } from "./types";
 export { MAX_PENDING_DEVICE_AUTHORIZATIONS } from "./types";
 //# sourceMappingURL=index.d.ts.map

package/dist/storage/auth/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/storage/auth/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACjD,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,4BAA4B,EAC5B,wBAAwB,EACxB,mBAAmB,EACnB,kBAAkB,EAClB,iCAAiC,EACjC,sCAAsC,EACtC,uBAAuB,EACvB,gBAAgB,EAChB,WAAW,EACX,qBAAqB,EACrB,aAAa,EACb,kBAAkB,EAClB,wBAAwB,EACxB,gCAAgC,EAChC,iCAAiC,EACjC,4BAA4B,EAC5B,uBAAuB,EACvB,oBAAoB,EACpB,0BAA0B,EAC1B,wBAAwB,EACxB,6BAA6B,EAC7B,sBAAsB,EACtB,mBAAmB,EACnB,8BAA8B,EAC9B,mCAAmC,EACnC,iCAAiC,EACjC,yBAAyB,EACzB,yBAAyB,EACzB,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,yBAAyB,EACzB,0BAA0B,EAC1B,wBAAwB,EACxB,yBAAyB,EACzB,4BAA4B,EAC5B,6BAA6B,EAC7B,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,8BAA8B,EAC9B,gDAAgD,EAChD,+BAA+B,EAC/B,mCAAmC,EACnC,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,iCAAiC,EACjC,6BAA6B,EAC7B,0BAA0B,EAC1B,yBAAyB,EACzB,8BAA8B,EAC9B,4CAA4C,EAC5C,2BAA2B,EAC3B,kBAAkB,EAClB,UAAU,EACV,UAAU,GACX,MAAM,SAAS,CAAA;AAChB,OAAO,EAAE,iCAAiC,EAAE,MAAM,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/storage/auth/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACjD,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,4BAA4B,EAC5B,wBAAwB,EACxB,mBAAmB,EACnB,kBAAkB,EAClB,iCAAiC,EACjC,sCAAsC,EACtC,uBAAuB,EACvB,gBAAgB,EAChB,WAAW,EACX,qBAAqB,EACrB,aAAa,EACb,kBAAkB,EAClB,wBAAwB,EACxB,gCAAgC,EAChC,iCAAiC,EACjC,4BAA4B,EAC5B,uBAAuB,EACvB,oBAAoB,EACpB,0BAA0B,EAC1B,wBAAwB,EACxB,6BAA6B,EAC7B,sBAAsB,EACtB,mBAAmB,EACnB,8BAA8B,EAC9B,mCAAmC,EACnC,iCAAiC,EACjC,yBAAyB,EACzB,yBAAyB,EACzB,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,yBAAyB,EACzB,0BAA0B,EAC1B,wBAAwB,EACxB,yBAAyB,EACzB,4BAA4B,EAC5B,6BAA6B,EAC7B,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,8BAA8B,EAC9B,gDAAgD,EAChD,+BAA+B,EAC/B,mCAAmC,EACnC,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,iCAAiC,EACjC,6BAA6B,EAC7B,0BAA0B,EAC1B,oBAAoB,EACpB,yBAAyB,EACzB,8BAA8B,EAC9B,4CAA4C,EAC5C,2BAA2B,EAC3B,kBAAkB,EAClB,UAAU,EACV,UAAU,GACX,MAAM,SAAS,CAAA;AAChB,OAAO,EAAE,iCAAiC,EAAE,MAAM,SAAS,CAAA"}

package/dist/storage/auth/types.d.ts

@@ -176,13 +176,19 @@ export interface CreateAuthUserInput {
     readonly createdAt?: Date;
     readonly updatedAt?: Date;
 }
+/** Omitted fields stay unchanged, and `null` clears one. */
 export interface UpdateAuthUserProfileInput {
     readonly projectId: string;
     readonly id: string;
-    readonly displayName?: string;
-    readonly avatarUrl?: string;
+    readonly displayName?: string | null;
+    readonly avatarUrl?: string | null;
     readonly updatedAt?: Date;
 }
+/** A change to one user, with the user as the change found them, read in the same atomic step. */
+export interface UpdateAuthUserResult {
+    readonly user: UserRecord;
+    readonly previousUser: UserRecord;
+}
 export interface UpdateAuthUserStatusInput {
     readonly projectId: string;
     readonly id: string;
@@ -192,6 +198,12 @@ export interface UpdateAuthUserStatusInput {
 export interface ListAuthUsersInput {
     readonly projectId: string;
     readonly statuses?: readonly UserStatus[];
+    /**
+     * Keep users whose display name or email contains this text, ignoring case. Matched literally:
+     * `%` and `_` are plain characters. `total` and `hasMore` count only the matches. SQLite ignores
+     * case for ASCII letters only.
+     */
+    readonly search?: string;
     readonly limit?: number;
     readonly offset?: number;
     readonly order?: "asc" | "desc";
@@ -387,10 +399,11 @@ export interface CompleteDeviceAuthorizationInput {
     readonly projectId: string;
     readonly id: string;
     readonly deviceCodeHash: string;
-    /** The bearer session to start for the approving user. */
-    readonly session: CreateAuthSessionInput & {
-        readonly bearer: BearerSessionState;
-    };
+    /**
+     * The session to start for the approving user: a bearer session for a native client, or a
+     * cookie session for a browser that asked to be approved from another one.
+     */
+    readonly session: CreateAuthSessionInput;
     readonly completedAt: Date;
 }
 export interface CompleteDeviceAuthorizationResult {
@@ -420,6 +433,10 @@ export interface CompleteOidcSignInInput {
      * links the user who has this email, or claims this email's invitation for a new user.
      */
     readonly email: string;
+    /**
+     * The name and picture the provider sends. Every sign-in sets them on the user, and one left out
+     * keeps the stored value. `updatedAt` moves only when one of them changes.
+     */
     readonly displayName?: string;
     readonly avatarUrl?: string;
     readonly claims?: Readonly<Record<string, unknown>>;
@@ -440,6 +457,11 @@ export interface CompleteSignInResult {
     readonly identity?: UserIdentityRecord;
     readonly invitation?: InvitationRecord;
     readonly groupMemberships: readonly GroupMembershipRecord[];
+    /**
+     * The user as this sign-in found them, before it changed their profile, or `null` when this
+     * sign-in created them.
+     */
+    readonly previousUser: UserRecord | null;
 }
 export interface SuspendUserAndRevokeSessionsInput {
     readonly projectId: string;
@@ -452,12 +474,21 @@ export interface AuthUserStore {
         readonly projectId: string;
         readonly id: string;
     }): Promise<UserRecord | null>;
+    /** The users of the project with these ids, in any order. Ids no user has are skipped. */
+    getByIds(params: {
+        readonly projectId: string;
+        readonly ids: readonly string[];
+    }): Promise<readonly UserRecord[]>;
     getByEmail(params: {
         readonly projectId: string;
         readonly email: string;
     }): Promise<UserRecord | null>;
-    updateProfile(input: UpdateAuthUserProfileInput): Promise<UserRecord>;
-    updateStatus(input: UpdateAuthUserStatusInput): Promise<UserRecord>;
+    /**
+     * Update only the provided fields; omitted fields must remain unchanged atomically. When no
+     * value changes, nothing is written, so `updatedAt` stays as it was.
+     */
+    updateProfile(input: UpdateAuthUserProfileInput): Promise<UpdateAuthUserResult>;
+    updateStatus(input: UpdateAuthUserStatusInput): Promise<UpdateAuthUserResult>;
     list(input: ListAuthUsersInput): Promise<ListAuthUsersResult>;
 }
 export interface AuthUserIdentityStore {
@@ -706,6 +737,6 @@ export interface AuthStorage {
     completeMagicLinkSignIn(input: CompleteMagicLinkSignInInput): Promise<CompleteSignInResult>;
     completeOidcSignIn(input: CompleteOidcSignInInput): Promise<CompleteSignInResult>;
     completeDeviceAuthorization(input: CompleteDeviceAuthorizationInput): Promise<CompleteDeviceAuthorizationResult>;
-    suspendUserAndRevokeSessions(input: SuspendUserAndRevokeSessionsInput): Promise<UserRecord>;
+    suspendUserAndRevokeSessions(input: SuspendUserAndRevokeSessionsInput): Promise<UpdateAuthUserResult>;
 }
 //# sourceMappingURL=types.d.ts.map