@q9labsai/chalk-client 4.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Q9Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT, OR OTHERWISE, ARISING FROM,
+OUT OF, OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,173 @@
+# @q9labsai/chalk-client
+
+`@q9labsai/chalk-client` is Chalk's framework-agnostic `SpaceClient`. It
+connects a person to a Space, maintains the live Episode, and exposes one
+consistent `SpaceSnapshot` for any UI layer.
+
+A Space is the durable place for collaboration: its identity, configuration,
+members, and living content persist between Episodes. An Episode is one bounded
+run of live activity in that Space. `join()` always targets the Space; an
+Episode emerges when appropriate.
+
+## Install
+
+```sh
+pnpm add @q9labsai/chalk-client
+```
+
+## Create and join a Space
+
+Your backend mints an `AccessGrant` with the server SDK. Pass it through to the
+client unchanged: it is an opaque signed envelope, so application code does
+not construct or inspect it.
+
+```ts
+import { createSpaceClient, type AccessGrant } from "@q9labsai/chalk-client";
+
+const client = createSpaceClient({
+  space: "design-review",
+  getAccess: async ({ space, reason }): Promise<AccessGrant> => {
+    const response = await fetch(`/api/chalk/spaces/${space}/access?reason=${reason}`);
+    if (!response.ok) throw new Error("Could not get access");
+    return response.json() as Promise<AccessGrant>;
+  },
+});
+
+await client.join({
+  displayName: "Ari",
+  microphone: true,
+  camera: false,
+});
+```
+
+`getAccess` receives `reason: "join" | "refresh" | "retry"`. `Connection`
+uses it for Entrance freshness, scheduled refresh, wake revalidation, and one
+refresh-and-retry after an access rejection. Keep the callback available for
+the full lifetime of the client.
+
+## Snapshot store
+
+`subscribe` and `getSnapshot` form a framework-neutral external-store contract.
+Each snapshot has referentially stable slices, so UI code can select only the
+state it needs.
+
+```ts
+const unsubscribe = client.subscribe(() => {
+  const snapshot = client.getSnapshot();
+  renderConnection(snapshot.connection.status);
+});
+
+const snapshot = client.getSnapshot();
+if (snapshot.self.can("sendChat")) {
+  await client.chat.send({ text: "Ready when you are." });
+}
+
+unsubscribe();
+```
+
+`SpaceSnapshot` contains these slices:
+
+- `connection`: status, live Episode summary, and the latest failure
+- `self`: local Participant identity, role, capabilities, hand state, and `can(capability)`
+- `participants`: roster and admission queue
+- `media`: device selection, local and remote media, screen share, and requests
+- `chat`: messages, pending sends, read receipts, unread count, and pagination
+- `reactions`: active transient reactions
+- `whiteboard`: availability and engine state
+
+## Lifecycle and Episode controls
+
+```ts
+await client.leave();
+await client.endEpisode();
+await client.extendEpisode(15);
+client.dispose();
+```
+
+`endEpisode` and `extendEpisode` are capability-gated. Use `dispose()` when
+the client will no longer be used; it releases the Connection and its resources.
+
+## Feature controllers
+
+Lifecycle stays flat on `SpaceClient`; feature commands are namespaced.
+
+```ts
+await client.media.setMicrophoneEnabled(true);
+await client.media.setCameraEnabled(true);
+await client.media.setScreenShareEnabled(true);
+await client.media.selectMicrophone("microphone-id");
+await client.media.selectCamera("camera-id");
+await client.media.selectSpeaker("speaker-id");
+await client.media.acceptRequest("request-id");
+await client.media.declineRequest("request-id");
+
+await client.chat.send({ text: "Hello" });
+await client.chat.loadOlder();
+await client.chat.markRead("message-id");
+const attachment = await client.chat.files.upload(file);
+const url = client.chat.files.url(attachment);
+
+await client.participants.assignRole("participant-id", "collaborator");
+await client.participants.mute("participant-id");
+await client.participants.stopVideo("participant-id");
+await client.participants.stopScreenShare("participant-id");
+await client.participants.requestMedia("participant-id", "microphone");
+await client.participants.remove("participant-id");
+await client.participants.admit("request-id");
+await client.participants.deny("request-id");
+await client.participants.raiseHand();
+await client.participants.lowerHand();
+await client.participants.renameSelf("Ari");
+
+await client.reactions.send("🎉");
+const transport = client.whiteboard.transport();
+```
+
+## Events and failures
+
+Use `on` for discrete events and snapshots for current state.
+
+```ts
+const stopListening = client.on("episodeEnded", ({ episode }) => {
+  showEpisodeHistory(episode?.id);
+});
+
+client.on("error", ({ error }) => {
+  reportSafeDiagnostic(error.code, error.recoverable);
+});
+
+stopListening();
+```
+
+Events are `participantJoined`, `participantLeft`, `episodeEnded`,
+`screenShareStarted`, `screenShareStopped`, and `error`. Public failures use
+stable codes such as `access.invalid`, `episode.ended`, and
+`chat.payload_invalid`.
+
+## Journey telemetry
+
+Client telemetry is opt-in. Start a `space.join` journey when a Participant
+joins a Space, pass its `context` to HTTP or Sync boundaries, and flush the
+bounded queue when the surface is ready to export:
+
+```ts
+import { createTelemetryClient } from "@q9labsai/chalk-client/telemetry";
+
+const telemetry = createTelemetryClient({ enabled: true, baseUrl: "https://api.example.com" });
+const journey = telemetry.startJourney({ kind: "space.join" });
+const response = await fetch("/api/chalk/spaces/design-review", { headers: journey.headers });
+journey.terminal(response.ok ? "succeeded" : "failed");
+await telemetry.flush();
+```
+
+Journey events carry `journey_id`, W3C `traceparent`, and optional
+`tracestate`. Attributes and the in-memory timeline are bounded, and the
+built-in client observations record aggregate RTC state only: access-grant
+contents, Participant identity, Space or Episode identifiers, media payloads,
+and request bodies stay out of telemetry.
+
+## Effect entry
+
+The default entry is Promise-based. Effect applications can use the
+`@q9labsai/chalk-client/effect` entry for the same `SpaceClient` shape as an
+Effect program.

package/dist/access/base64-url.d.ts

@@ -0,0 +1,2 @@
+export declare function decodeBase64Url(value: string): string;
+//# sourceMappingURL=base64-url.d.ts.map

package/dist/access/base64-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64-url.d.ts","sourceRoot":"","sources":["../../src/access/base64-url.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOrD"}

package/dist/access/episode-diagnostic-credential.d.ts

@@ -0,0 +1,11 @@
+declare const INTAKE_PATH: "/_internal/episode-diagnostic-events";
+export type EpisodeDiagnosticCredential = Readonly<{
+    token: string;
+    expiresAt: string;
+    generation: number;
+    intakePath: typeof INTAKE_PATH;
+}>;
+export declare function parseEpisodeDiagnosticCredential(value: unknown): EpisodeDiagnosticCredential | null;
+export declare function validEpisodeDiagnosticCredential(credential: EpisodeDiagnosticCredential, now: number): boolean;
+export {};
+//# sourceMappingURL=episode-diagnostic-credential.d.ts.map

package/dist/access/episode-diagnostic-credential.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"episode-diagnostic-credential.d.ts","sourceRoot":"","sources":["../../src/access/episode-diagnostic-credential.ts"],"names":[],"mappings":"AAEA,QAAA,MAAM,WAAW,EAAG,sCAA+C,CAAC;AAGpE,MAAM,MAAM,2BAA2B,GAAG,QAAQ,CAAC;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,OAAO,WAAW,CAAC;CAChC,CAAC,CAAC;AAEH,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,OAAO,GAAG,2BAA2B,GAAG,IAAI,CAWnG;AAED,wBAAgB,gCAAgC,CAAC,UAAU,EAAE,2BAA2B,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAE9G"}

package/dist/access/grant.d.ts

@@ -0,0 +1,53 @@
+import { type EpisodeDiagnosticCredential } from "./episode-diagnostic-credential";
+declare const syncCredentialBrand: unique symbol;
+declare const mediaCredentialBrand: unique symbol;
+declare const accessGrantBrand: unique symbol;
+export type ParticipantSyncCredential = string & {
+    readonly [syncCredentialBrand]: "chalk-sync";
+};
+export type ParticipantMediaCredential = string & {
+    readonly [mediaCredentialBrand]: "chalk-media";
+};
+export type AccessSubject = {
+    readonly tenantId: string;
+    readonly spaceId: string;
+    readonly episodeId: string;
+    readonly participantId: string;
+    readonly participantGeneration: number;
+};
+export type ParticipantSyncAccess = {
+    readonly token: ParticipantSyncCredential;
+    readonly expiresAt: string;
+};
+export type ParticipantMediaAccess = {
+    readonly token: ParticipantMediaCredential;
+    readonly expiresAt: string;
+    readonly provider: "cloudflare_sfu";
+    readonly clientPayload: {
+        readonly connectionId: string;
+        readonly stunServer: string;
+    };
+};
+export type ParsedAccessGrant = {
+    readonly subject: AccessSubject;
+    readonly sync: ParticipantSyncAccess;
+    readonly media: ParticipantMediaAccess;
+    readonly diagnostics?: EpisodeDiagnosticCredential | null;
+};
+/** Opaque signed envelope minted by the server SDK and consumed by SpaceClient. */
+export type AccessGrant = {
+    readonly [accessGrantBrand]: "AccessGrant";
+};
+export type AccessGrantProvider = () => ParsedAccessGrant | Promise<ParsedAccessGrant>;
+export declare class AccessGrantError extends TypeError {
+    readonly code: "access.invalid";
+    constructor(message?: string);
+}
+export declare function parseParsedAccessGrant(value: unknown): ParsedAccessGrant;
+export declare function parseAccessGrant(value: unknown): AccessGrant;
+export declare function accessGrantFromParsed(value: ParsedAccessGrant): AccessGrant;
+export declare function requireParsedAccessGrant(value: unknown): Promise<ParsedAccessGrant>;
+export declare function requireAccessGrant(value: unknown): Promise<AccessGrant>;
+export declare function isParsedAccessGrant(value: unknown): value is ParsedAccessGrant;
+export {};
+//# sourceMappingURL=grant.d.ts.map

package/dist/access/grant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grant.d.ts","sourceRoot":"","sources":["../../src/access/grant.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AAGrH,OAAO,CAAC,MAAM,mBAAmB,EAAE,OAAO,MAAM,CAAC;AACjD,OAAO,CAAC,MAAM,oBAAoB,EAAE,OAAO,MAAM,CAAC;AAClD,QAAA,MAAM,gBAAgB,EAAE,OAAO,MAA8B,CAAC;AAE9D,MAAM,MAAM,yBAAyB,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,mBAAmB,CAAC,EAAE,YAAY,CAAA;CAAE,CAAC;AAClG,MAAM,MAAM,0BAA0B,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,oBAAoB,CAAC,EAAE,aAAa,CAAA;CAAE,CAAC;AAErG,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,KAAK,EAAE,yBAAyB,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,KAAK,EAAE,0BAA0B,CAAC;IAC3C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE;QACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;KAC7B,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,sBAAsB,CAAC;IACvC,QAAQ,CAAC,WAAW,CAAC,EAAE,2BAA2B,GAAG,IAAI,CAAC;CAC3D,CAAC;AAEF,mFAAmF;AACnF,MAAM,MAAM,WAAW,GAAG;IAAE,QAAQ,CAAC,CAAC,gBAAgB,CAAC,EAAE,aAAa,CAAA;CAAE,CAAC;AAEzE,MAAM,MAAM,mBAAmB,GAAG,MAAM,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAEvF,qBAAa,gBAAiB,SAAQ,SAAS;IAC7C,QAAQ,CAAC,IAAI,EAAG,gBAAgB,CAAU;IAE1C,YAAY,OAAO,SAA4B,EAG9C;CACF;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,CAUxE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAE5D;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,iBAAiB,GAAG,WAAW,CA4B3E;AAED,wBAAsB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAWzF;AAED,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CAW7E;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAO9E"}

package/dist/access/grant.test.helpers.d.ts

@@ -0,0 +1,10 @@
+import type { ParsedAccessGrant } from "./grant";
+export declare const ACCESS_SUBJECT: {
+    readonly tenantId: "tenant-1";
+    readonly spaceId: "space-1";
+    readonly episodeId: "episode-1";
+    readonly participantId: "participant-1";
+    readonly participantGeneration: 1;
+};
+export declare function accessGrant(expiresAt: number, suffix: string, connectionId?: string): ParsedAccessGrant;
+//# sourceMappingURL=grant.test.helpers.d.ts.map

package/dist/access/grant.test.helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grant.test.helpers.d.ts","sourceRoot":"","sources":["../../src/access/grant.test.helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD,eAAO,MAAM,cAAc;aACzB,QAAQ,EAAE,UAAU;aACpB,OAAO,EAAE,SAAS;aAClB,SAAS,EAAE,WAAW;aACtB,aAAa,EAAE,eAAe;aAC9B,qBAAqB,EAAE,CAAC;CAChB,CAAC;AAEX,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,SAAiB,GAAG,iBAAiB,CAM/G"}

package/dist/access/manager.d.ts

@@ -0,0 +1,36 @@
+import { Context, Effect, Layer } from "effect";
+import type { ParsedAccessGrant, ParticipantMediaCredential, ParticipantSyncCredential } from "./grant";
+import type { ConnectionAccessReason, ConnectionAccessRequest } from "../connection/dependencies";
+declare const ConnectionAccessFailure_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "ConnectionAccessFailure";
+} & Readonly<A>;
+export declare class ConnectionAccessFailure extends ConnectionAccessFailure_base<{
+    readonly code: "access.invalid" | "access.unavailable";
+    readonly cause: unknown;
+}> {
+}
+export type ConnectionAccessEffectProvider = (request: ConnectionAccessRequest) => Effect.Effect<ParsedAccessGrant, ConnectionAccessFailure>;
+export type ConnectionAccessEffectService = {
+    readonly current: Effect.Effect<ParsedAccessGrant | null>;
+    readonly currentUnsafe: () => ParsedAccessGrant | null;
+    readonly initialize: (reason?: "join" | "access_retry") => Effect.Effect<ParsedAccessGrant, ConnectionAccessFailure>;
+    readonly ensureFresh: (reason?: ConnectionAccessReason) => Effect.Effect<ParsedAccessGrant, ConnectionAccessFailure>;
+    readonly refresh: (reason: Exclude<ConnectionAccessReason, "join">, replaceMediaConnection: boolean) => Effect.Effect<ParsedAccessGrant, ConnectionAccessFailure>;
+    readonly refreshAfterRejection: () => Effect.Effect<ParsedAccessGrant, ConnectionAccessFailure>;
+    readonly getSyncToken: (reason?: ConnectionAccessReason) => Effect.Effect<ParticipantSyncCredential, ConnectionAccessFailure>;
+    readonly getMediaToken: () => Effect.Effect<ParticipantMediaCredential, ConnectionAccessFailure>;
+    readonly requiresRefresh: Effect.Effect<boolean>;
+    readonly millisecondsUntilRefresh: Effect.Effect<number | null>;
+    readonly clear: Effect.Effect<void>;
+};
+declare const ConnectionAccessService_base: Context.ServiceClass<ConnectionAccessService, "@chalk/client/ConnectionAccess", ConnectionAccessEffectService>;
+export declare class ConnectionAccessService extends ConnectionAccessService_base {
+}
+/**
+ * The sole R1 owner. SynchronizedRef keeps a refresh and its state commit
+ * indivisible, while Clock keeps expiry decisions deterministic in tests.
+ */
+export declare const makeConnectionAccessLayer: (provider: ConnectionAccessEffectProvider, refreshWindowMs?: number) => Layer.Layer<ConnectionAccessService, never, never>;
+export declare const makeFakeConnectionAccessLayer: (provider: ConnectionAccessEffectProvider, refreshWindowMs?: number) => Layer.Layer<ConnectionAccessService, never, never>;
+export {};
+//# sourceMappingURL=manager.d.ts.map

package/dist/access/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/access/manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,OAAO,EAAQ,MAAM,EAAE,KAAK,EAAmB,MAAM,QAAQ,CAAC;AAC9E,OAAO,KAAK,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AACxG,OAAO,KAAK,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;;;;AAIlG,qBAAa,uBAAwB,SAAQ,6BAA4C;IACvF,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,oBAAoB,CAAC;IACvD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB,CAAC;CAAG;AAEL,MAAM,MAAM,8BAA8B,GAAG,CAAC,OAAO,EAAE,uBAAuB,KAAK,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE,uBAAuB,CAAC,CAAC;AAE7I,MAAM,MAAM,6BAA6B,GAAG;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IAC1D,QAAQ,CAAC,aAAa,EAAE,MAAM,iBAAiB,GAAG,IAAI,CAAC;IACvD,QAAQ,CAAC,UAAU,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,cAAc,KAAK,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE,uBAAuB,CAAC,CAAC;IACrH,QAAQ,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,EAAE,sBAAsB,KAAK,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE,uBAAuB,CAAC,CAAC;IACrH,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,sBAAsB,EAAE,MAAM,CAAC,EAAE,sBAAsB,EAAE,OAAO,KAAK,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE,uBAAuB,CAAC,CAAC;IAClK,QAAQ,CAAC,qBAAqB,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE,uBAAuB,CAAC,CAAC;IAChG,QAAQ,CAAC,YAAY,EAAE,CAAC,MAAM,CAAC,EAAE,sBAAsB,KAAK,MAAM,CAAC,MAAM,CAAC,yBAAyB,EAAE,uBAAuB,CAAC,CAAC;IAC9H,QAAQ,CAAC,aAAa,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,0BAA0B,EAAE,uBAAuB,CAAC,CAAC;IACjG,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACjD,QAAQ,CAAC,wBAAwB,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAChE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;CACrC,CAAC;;AAEF,qBAAa,uBAAwB,SAAQ,4BAA2G;CAAG;AAI3J;;;GAGG;AACH,eAAO,MAAM,yBAAyB,aAAc,8BAA8B,iFAqD/E,CAAC;AAEJ,eAAO,MAAM,6BAA6B,aAvDU,8BAA8B,iFAuDZ,CAAC"}

package/dist/chat-files/http-transport.d.ts

@@ -0,0 +1,8 @@
+import { type ChalkChatFileTransport } from "./types";
+export type ChalkChatFileHttpTransportOptions = {
+    readonly baseUrl: string;
+    readonly token: () => Promise<string>;
+    readonly fetch?: typeof globalThis.fetch;
+};
+export declare function createChalkChatFileHttpTransport(options: ChalkChatFileHttpTransportOptions): ChalkChatFileTransport;
+//# sourceMappingURL=http-transport.d.ts.map

package/dist/chat-files/http-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-transport.d.ts","sourceRoot":"","sources":["../../src/chat-files/http-transport.ts"],"names":[],"mappings":"AACA,OAAO,EAA8E,KAAK,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAElI,MAAM,MAAM,iCAAiC,GAAG;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CAC1C,CAAC;AAKF,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,iCAAiC,GAAG,sBAAsB,CAmBnH"}

package/dist/chat-files/index.d.ts

@@ -0,0 +1,3 @@
+export { createChalkChatFileHttpTransport, type ChalkChatFileHttpTransportOptions } from "./http-transport";
+export { ChalkChatFileError, type ChalkChatFileErrorCode, type ChalkChatFileFailure, type ChalkChatFileOperation, type ChalkChatFileTransport } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/chat-files/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/chat-files/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gCAAgC,EAAE,KAAK,iCAAiC,EAAE,MAAM,kBAAkB,CAAC;AAC5G,OAAO,EAAE,kBAAkB,EAAE,KAAK,sBAAsB,EAAE,KAAK,oBAAoB,EAAE,KAAK,sBAAsB,EAAE,KAAK,sBAAsB,EAAE,MAAM,SAAS,CAAC"}

package/dist/chat-files/types.d.ts

@@ -0,0 +1,37 @@
+import type { ChalkChatAttachment, ChalkChatAttachmentMimeType } from "../collaboration/types";
+export type ChalkChatFileOperation = "initiate_upload" | "finalize_upload" | "get_download";
+export type ChalkChatFileErrorCode = "access.invalid" | "unavailable" | "permission_denied" | "invalid_payload" | "conflict" | "not_found" | "expired" | "file_transfer_failed";
+export type ChalkChatFileFailure = {
+    readonly operation: ChalkChatFileOperation;
+    readonly code: ChalkChatFileErrorCode;
+    readonly recoverable: boolean;
+    readonly message: string;
+};
+export declare class ChalkChatFileError extends Error {
+    readonly operation: ChalkChatFileOperation;
+    readonly code: ChalkChatFileErrorCode;
+    readonly recoverable: boolean;
+    constructor(failure: ChalkChatFileFailure, options?: ErrorOptions);
+}
+export type ChalkChatFileTransport = {
+    readonly initiateUpload: (input: {
+        readonly clientAttachmentId: string;
+        readonly fileName: string;
+        readonly mimeType: ChalkChatAttachmentMimeType;
+        readonly byteLength: number;
+        readonly sha256: string;
+    }) => Promise<{
+        readonly attachmentId: string;
+        readonly uploadId: string;
+        readonly method: "PUT";
+        readonly uploadUrl: string;
+        readonly headers: Readonly<Record<string, string>>;
+        readonly expiresAt: string;
+    }>;
+    readonly finalizeUpload: (uploadId: string) => Promise<ChalkChatAttachment>;
+    readonly getDownloadUrl: (attachmentId: string) => Promise<{
+        readonly downloadUrl: string;
+        readonly expiresAt: string;
+    }>;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/chat-files/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/chat-files/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAE/F,MAAM,MAAM,sBAAsB,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,cAAc,CAAC;AAE5F,MAAM,MAAM,sBAAsB,GAAG,gBAAgB,GAAG,aAAa,GAAG,mBAAmB,GAAG,iBAAiB,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,GAAG,sBAAsB,CAAC;AAEhL,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,SAAS,EAAE,sBAAsB,CAAC;IAC3C,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,SAAS,EAAE,sBAAsB,CAAC;IAC3C,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAE9B,YAAY,OAAO,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,YAAY,EAMhE;CACF;AAED,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,cAAc,EAAE,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,2BAA2B,CAAC;QAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC;QACpN,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;QACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QACnD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;KAC5B,CAAC,CAAC;IACH,QAAQ,CAAC,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC5E,QAAQ,CAAC,cAAc,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC;QACzD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;KAC5B,CAAC,CAAC;CACJ,CAAC"}