@drawnagency/primitives 0.1.110 → 0.1.112

package/dist/deck-builder/deck-api.d.ts

@@ -0,0 +1,76 @@
+import { type Deck } from "../schemas/deck";
+/**
+ * The builder's client for `/api/decks` (ADR 0002's routes).
+ *
+ * Every function returns a discriminated result instead of throwing, because
+ * every failure mode here is one the UI has to SAY something specific about —
+ * a 409 is not an error to log, it is a decision to put in front of the author.
+ */
+/**
+ * Just the sidecar fields the grid renders, narrowed from the response rather
+ * than cast to `DeckMeta`.
+ *
+ * Deliberately NOT the whole sidecar and NOT `parseDeckMeta`: the meta schema
+ * pins `schemaVersion` to a literal, so validating the full shape here would
+ * make a portal running an older package version drop every deck from the
+ * listing — silently, and exactly for the user whose decks they are. Reading
+ * only what is displayed keeps a schema bump a non-event on this side.
+ */
+export interface PublishedDeckMeta {
+    title: string;
+    slideCount: number;
+    updatedAt: string;
+}
+export interface PublishedDeckSummary {
+    id: string;
+    version: string;
+    /** null when the route reported the sidecar unreadable, or a field is missing. */
+    meta: PublishedDeckMeta | null;
+}
+export type DeckApiFailure = 
+/** 409 — the deck moved on the branch since this draft's baseVersion. */
+{
+    kind: "conflict";
+    currentVersion: string | null;
+    message: string;
+}
+/** 400 — the deck did not satisfy the schema. Per-path messages. */
+ | {
+    kind: "invalid";
+    details: string[];
+}
+/** 401/403 — not signed in, or not a Deck Creator. */
+ | {
+    kind: "forbidden";
+    message: string;
+}
+/** 404 — no such deck, or not one this caller may see. */
+ | {
+    kind: "notFound";
+}
+/** 503 and transport failures — nothing was written and a retry is right. */
+ | {
+    kind: "unavailable";
+    message: string;
+} | {
+    kind: "failed";
+    message: string;
+};
+export type DeckApiResult<T> = {
+    ok: true;
+    value: T;
+} | ({
+    ok: false;
+} & DeckApiFailure);
+export declare function listPublishedDecks(): Promise<DeckApiResult<PublishedDeckSummary[]>>;
+export declare function readPublishedDeck(id: string): Promise<DeckApiResult<{
+    deck: Deck;
+    version: string;
+    meta: PublishedDeckMeta | null;
+}>>;
+export declare function publishDeck(deck: Deck, baseVersion: string | null): Promise<DeckApiResult<{
+    version: string;
+    meta: PublishedDeckMeta | null;
+}>>;
+export declare function deletePublishedDeck(id: string): Promise<DeckApiResult<true>>;
+//# sourceMappingURL=deck-api.d.ts.map

package/dist/deck-builder/deck-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deck-api.d.ts","sourceRoot":"","sources":["../../src/deck-builder/deck-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAEvD;;;;;;GAMG;AAEH;;;;;;;;;GASG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAAC;CAChC;AAUD,MAAM,MAAM,cAAc;AACxB,yEAAyE;AACvE;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE;AACtE,oEAAoE;GAClE;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE;AACxC,sDAAsD;GACpD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE;AACxC,0DAA0D;GACxD;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE;AACtB,6EAA6E;GAC3E;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAExC,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GAAG,CAAC;IAAE,EAAE,EAAE,KAAK,CAAA;CAAE,GAAG,cAAc,CAAC,CAAC;AAgDzF,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,aAAa,CAAC,oBAAoB,EAAE,CAAC,CAAC,CAsBzF;AAED,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,aAAa,CAAC;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAAA;CAAE,CAAC,CAAC,CAczF;AAED,wBAAsB,WAAW,CAC/B,IAAI,EAAE,IAAI,EACV,WAAW,EAAE,MAAM,GAAG,IAAI,GACzB,OAAO,CAAC,aAAa,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAAA;CAAE,CAAC,CAAC,CAgB7E;AAED,wBAAsB,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAWlF"}

package/dist/deck-builder/deck-chat-client.d.ts

@@ -0,0 +1,44 @@
+import { type Deck } from "../schemas/deck";
+/**
+ * The builder's client for `POST /api/deck-chat` (#35).
+ *
+ * The route's event contract, and what each event means to the UI:
+ *
+ *   text   { text }              a delta of the assistant's prose
+ *   retry  { attempt, issues }   the model's deck failed validation and it is
+ *                                being asked to fix it — DISCARD the prose
+ *                                streamed so far, or the transcript shows two
+ *                                answers for one turn
+ *   deck   { deck }              a deck that PARSED server-side; stage it
+ *   error  { error, details? }   the turn produced no usable deck
+ *   done   { truncated }         end of turn (always last)
+ *
+ * A turn with no `deck` event is not a failure: the assistant is allowed to
+ * answer a question without rewriting the deck.
+ */
+export interface DeckChatMessage {
+    role: "user" | "assistant";
+    content: string;
+}
+export interface DeckChatHandlers {
+    onText: (delta: string) => void;
+    /** Prose from the failed attempt must be dropped before the next one streams. */
+    onRetry: (attempt: number, issues: string[]) => void;
+}
+export type DeckChatResult = {
+    ok: true;
+    deck: Deck | null;
+    truncated: boolean;
+} | {
+    ok: false;
+    error: string;
+    details?: string[];
+    retryAfterMs?: number;
+};
+export declare const DECK_CHAT_ERROR_COPY: Record<string, string>;
+export declare function deckChatCanRetry(error: string): boolean;
+export declare function streamDeckChat(body: {
+    deck: Deck;
+    messages: DeckChatMessage[];
+}, handlers: DeckChatHandlers, signal?: AbortSignal): Promise<DeckChatResult>;
+//# sourceMappingURL=deck-chat-client.d.ts.map

package/dist/deck-builder/deck-chat-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deck-chat-client.d.ts","sourceRoot":"","sources":["../../src/deck-builder/deck-chat-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAEvD;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,iFAAiF;IACjF,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;CACtD;AAED,MAAM,MAAM,cAAc,GACtB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,GACnD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5E,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAcvD,CAAC;AAMF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,wBAAsB,cAAc,CAClC,IAAI,EAAE;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,eAAe,EAAE,CAAA;CAAE,EACjD,QAAQ,EAAE,gBAAgB,EAC1B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,cAAc,CAAC,CAiEzB"}

package/dist/deck-builder/deck-chat-history.d.ts

@@ -0,0 +1,10 @@
+import type { DeckChatMessage } from "./deck-chat-client";
+/** Turns kept per deck. A turn is a user line plus a reply; 60 is a long
+ *  authoring session and still a bounded localStorage footprint. */
+export declare const DECK_CHAT_MESSAGE_CAP = 60;
+export declare function loadDeckChat(scope: string, deckId: string): DeckChatMessage[];
+/** Empty turns (the mid-stream assistant stub) are never stored. */
+export declare function saveDeckChat(scope: string, deckId: string, messages: DeckChatMessage[]): void;
+/** Called when a deck is deleted: its conversation goes with it. */
+export declare function clearDeckChat(scope: string, deckId: string): void;
+//# sourceMappingURL=deck-chat-history.d.ts.map

package/dist/deck-builder/deck-chat-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deck-chat-history.d.ts","sourceRoot":"","sources":["../../src/deck-builder/deck-chat-history.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAiB1D;oEACoE;AACpE,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAexC,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,eAAe,EAAE,CAO7E;AAED,oEAAoE;AACpE,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,GAAG,IAAI,CAQ7F;AAED,oEAAoE;AACpE,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAMjE"}

package/dist/deck-builder/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The Deck Builder — a sealed subtree like ./deck and ./document.
+ *
+ * NOT re-exported from the primitives root barrel: this graph reaches the deck
+ * runtime, and nothing on an ordinary viewer page may pull that in. Only the
+ * builder route (`core/src/pages/decks.astro`) imports from here, as a
+ * `client:only` island, so the whole thing is paid for by opening the builder
+ * and by nothing else.
+ */
+export { DeckBuilderApp } from "./DeckBuilderApp";
+export { starterDeck, newDeckId } from "./starter-deck";
+export type { DeckGridEntry } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/deck-builder/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/deck-builder/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACxD,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC"}