@superblocksteam/library-shared 1.99.99-next.3 → 2.0.0-SNAPSHOT.04704c19f32b3902

package/dist/types/migration.d.ts

@@ -0,0 +1,240 @@
+/**
+ * Wire types for the v2→v3 migration flow. Shared between the vite dev
+ * server (`vite-plugin-file-sync/src/migration/*`) and the editor UI
+ * (`ui/src/app/pages/components/migrateToV3/*`). Anything that crosses
+ * the `/sb-migration-status` boundary belongs here so a new phase or
+ * checklist field added on one side is a compile error on the other.
+ *
+ * ## State ownership (see `vite-plugin-file-sync/src/migration/README.md`)
+ *
+ * - **Server session** (`MigrationSessionResponse`): phase, generation, abort,
+ *   backup/migration/completion commit IDs. Authoritative after CP4.
+ * - **Dev-server scratch** (`MigrationStatusResponse`): checklist,
+ *   `integrationWritePolicy`, verification progress. Authoritative for in-pod work.
+ *
+ * `integrationWritePolicy` appears on both shapes for API symmetry, but only scratch
+ * is populated and enforced today. The Postgres column and `POST /migration/start`
+ * body field are schema placeholders — not part of CP1–CP4 delivery.
+ */
+/**
+ * Checklist-derived phases exposed on `GET /sb-migration-status` after CP4.
+ * `backup`, `restructure`, and `flip` remain for in-process POST handlers
+ * only — they are not returned on GET.
+ */
+export type MigrationPhase = "idle"
+/** @deprecated Not returned on GET /sb-migration-status (CP4). */
+ | "backup"
+/** @deprecated Not returned on GET /sb-migration-status (CP4). */
+ | "restructure"
+/** @deprecated Not returned on GET /sb-migration-status (CP4). */
+ | "flip" | "translating" | "done" | "done_with_unresolved" | "failed";
+export type MigrationChecklistStatus = "pending" | "in_progress" | "completed" | "cancelled" | "failed";
+export type MigrationChecklistOverallStatus = "active" | "completed";
+export type MigrationChecklistOrigin = "2.0-upgrade" | "clark" | "seed_api" | "seed_phase";
+export interface MigrationChecklistItem {
+    id: string;
+    content: string;
+    status: MigrationChecklistStatus;
+    createdAt: string;
+    updatedAt?: string;
+    origin: MigrationChecklistOrigin;
+    /**
+     * Whether this checklist item should be removed automatically once a
+     * successful build finalize completes.
+     */
+    clearOnFinalize?: boolean;
+    apiName?: string;
+    stubPath?: string;
+    /** Populated when `status === "failed"`. */
+    failureReason?: string;
+    /**
+     * Number of prior translation attempts recorded on this item.
+     * Bumped each time the user invokes "Fix with Clark" on a failed
+     * row — the row flips back to `pending` and this counter
+     * increments. The initial agent run counts as attempt 0; the first
+     * manual retry produces `attemptCount = 1`, and so on. There is no
+     * automatic retry, so the counter is only non-zero once a user has
+     * explicitly asked for another attempt.
+     */
+    attemptCount?: number;
+    /**
+     * Most recent `failureReason` observed for this item, preserved
+     * across status transitions so a retry prompt can carry context
+     * even after the row is flipped back to `pending`.
+     */
+    lastFailureReason?: string;
+    /**
+     * When set, verification was skipped for this item.
+     * `"mutation"` means the API contains write operations so running it
+     * automatically is unsafe. `"v2_unrunnable"` means the v2 baseline
+     * could not be executed (e.g. missing credentials, unsupported block
+     * type). `"both_failed"` means both v2 and v3 errored — typically because
+     * the API requires inputs from the frontend that aren't supplied during
+     * background verification — so we couldn't establish parity automatically.
+     * `"testing_denied"` means the user denied automatic testing; the API needs
+     * manual verification before production use.
+     */
+    verificationSkippedReason?: "both_failed" | "mutation" | "testing_denied" | "v2_unrunnable";
+    /**
+     * The outcome of the most recent verification run for this item.
+     * `"auto_passed"` means Clark confirmed v2 and v3 outputs match.
+     * `"user_manually_verified"` means the user confirmed equivalence
+     * by hand. `"diverged_user_accepted"` means the user accepted a
+     * known diff.
+     */
+    verificationOutcome?: "auto_passed" | "user_manually_verified" | "diverged_user_accepted";
+    /** Filesystem path to the last comparison diff written by the verifier. */
+    lastVerificationDiffPath?: string;
+    /** ISO-8601 timestamp of the last verification attempt. */
+    lastVerificationAt?: string;
+    /**
+     * Identifier of the coding sub-agent that owns this item, set by
+     * `spawnCodingSubagents` before fan-out when Clark passes `apiNames` per
+     * worker. Used purely for UI grouping (batch rows in `ChecklistDisplay`);
+     * unset on items migrated sequentially in the main agent's turn.
+     */
+    workerId?: string;
+    /**
+     * Forward-scaffolding shape for structured detail captured from the
+     * most recent verification run (planned writer:
+     * `scratch/migration-verification/<api>.history.json`). The writer
+     * and consumers (chat checklist deep-dive, agent-facing summary)
+     * land in a follow-up PR; the field is included here so the
+     * cross-package wire shape doesn't churn when that PR ships. No
+     * code currently sets or reads `details` — treat it as reserved.
+     */
+    details?: {
+        /** Last error returned when running the v2 baseline of this API. */
+        v2Error?: string;
+        /** Last error returned when running the migrated v3 of this API. */
+        v3Error?: string;
+        /**
+         * Names of inputs the verifier could not synthesize a value for
+         * (e.g. UI-bound parameters that have no recorded test value).
+         */
+        missingInputs?: string[];
+        /** Display name of the integration the API binds to. */
+        integrationName?: string;
+        /**
+         * Concise, agent-readable summary of why verification failed and
+         * what (if anything) Clark could try next.
+         */
+        summaryForAgent?: string;
+    };
+}
+export type IntegrationWritePolicy = "allow" | "deny";
+export interface MigrationIntegrationEntry {
+    id: string;
+    displayName: string;
+    defaultPolicy: "allow" | "deny";
+    /** Classification of the integration's write behaviour derived from v2 YAML analysis. */
+    mutationKind: "read" | "write" | "unknown";
+}
+/** Server-owned migration session phases (DB `application_migration_session.phase`). */
+export declare const MIGRATION_SESSION_PHASES: readonly ["aborting", "aborted", "failed", "in_progress", "preparing_postflip", "preparing_preflip"];
+export type MigrationSessionPhase = (typeof MIGRATION_SESSION_PHASES)[number];
+/** Phases that block a new `POST /migration/start`. */
+export declare const ACTIVE_MIGRATION_SESSION_PHASES: readonly ["aborting", "in_progress", "preparing_postflip", "preparing_preflip"];
+export type ActiveMigrationSessionPhase = (typeof ACTIVE_MIGRATION_SESSION_PHASES)[number];
+export declare const MIGRATION_FAILURE_STAGES: readonly ["abort", "in_progress", "postflip", "preflip"];
+export type MigrationFailureStage = (typeof MIGRATION_FAILURE_STAGES)[number];
+export declare const DEFAULT_MIGRATION_TARGET_TEMPLATE_NAME = "app-fullstack";
+/** Max wall-clock time for server abort saga + UI stale detection (5 minutes). */
+export declare const MIGRATION_ABORT_MAX_DURATION_MS: number;
+/** Server abort saga resume cursor (`application_migration_session.abort_checkpoint`). */
+export declare const MIGRATION_ABORT_CHECKPOINTS: readonly ["requested", "restored", "terminated"];
+export type MigrationAbortCheckpoint = (typeof MIGRATION_ABORT_CHECKPOINTS)[number];
+export interface MigrationSessionResponse {
+    applicationId: string;
+    branchName: string;
+    generation: number;
+    phase: MigrationSessionPhase;
+    failureStage?: MigrationFailureStage;
+    errorMessage?: string;
+    sourceTemplateName?: string;
+    targetTemplateName: string;
+    backupCommitId?: string;
+    migrationCommitId?: string;
+    completionCommitId?: string;
+    /** Schema placeholder — not written or read for enforcement today. See module header. */
+    integrationWritePolicy?: Record<string, IntegrationWritePolicy>;
+    /** True when UI should reload (post-flip pod recycle window). */
+    reloadRecommended: boolean;
+    startedAt: string;
+    updatedAt: string;
+    /** ISO-8601 timestamp when `POST /migration/abort` entered `aborting`. */
+    abortStartedAt?: string;
+    abortCheckpoint?: MigrationAbortCheckpoint;
+    abortedAt?: string;
+    completedAt?: string;
+    failedAt?: string;
+}
+export interface MigrationSessionPayload {
+    session: MigrationSessionResponse | null;
+}
+export interface MigrationStartRequestBody {
+    /** Accepted but not persisted — policy is saved via `/sb-migration-set-write-policy`. */
+    integrationWritePolicy?: Record<string, IntegrationWritePolicy>;
+    targetTemplateName?: string;
+}
+export interface MigrationStartResponse {
+    accepted: true;
+    generation: number;
+}
+export interface MigrationAbortResponse {
+    accepted: true;
+    /** True when another abort saga is already running within the max duration window. */
+    inProgress?: boolean;
+    session: MigrationSessionResponse | null;
+}
+/** Optional body for POST .../migration/abort when the server session row was cleared. */
+export interface MigrationAbortRequestBody {
+    backupCommitId?: string;
+    /** When true on an expired aborting session, reset the abort clock for a user-initiated retry. */
+    freshRetry?: boolean;
+}
+/**
+ * Aggregate view of normal (non-focused-debug) Clark migration turns,
+ * derived from the dev server's `scratch/migration-turns.jsonl` log.
+ * The UI uses this to decide when the initial migration generation has
+ * genuinely finished (e.g. to dismiss the "Upgrading your app" overlay)
+ * without client-side heuristics. `settledOutcome` reflects the most
+ * recent normal settle.
+ */
+export interface MigrationInitialTurnSummary {
+    dispatched: boolean;
+    settled: boolean;
+    settledOutcome?: "error" | "success";
+}
+export interface MigrationStatusResponse {
+    state: MigrationPhase;
+    error?: string;
+    /** Normal migration turn dispatch/settle summary from the dev server turn log. */
+    initialTurn?: MigrationInitialTurnSummary;
+    backupCommitId?: string;
+    migrationCommitId?: string;
+    startedAt?: string;
+    hasV2Backup: boolean;
+    checklist?: {
+        overallStatus: MigrationChecklistOverallStatus;
+        items: MigrationChecklistItem[];
+        lastUpdated: string;
+    };
+    /** Integration IDs discovered from v2-backup YAML files, populated once hasV2Backup is true. */
+    integrations?: MigrationIntegrationEntry[];
+    /** Per-integration write policy — source of truth in scratch; enforced by dev server. */
+    integrationWritePolicy?: Record<string, IntegrationWritePolicy>;
+    /**
+     * Set on the idle preflight when the live app references plugin IDs
+     * that are not in the fullstack `SUPPORTED_PLUGIN_IDS` allowlist.
+     * Migration is still allowed to proceed — the modal surfaces the
+     * lists below so the user can decide whether to attempt a Clark
+     * translation despite the gap.
+     */
+    hasUnsupportedIntegrations?: boolean;
+    /** Plugin IDs (e.g. "redis", "python") that aren't supported by the v3 runtime. */
+    unsupportedIntegrationIds?: string[];
+    /** v2 API names that reference at least one unsupported integration. */
+    unsupportedApiNames?: string[];
+}
+//# sourceMappingURL=migration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"migration.d.ts","sourceRoot":"","sources":["../../src/types/migration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;GAIG;AACH,MAAM,MAAM,cAAc,GACtB,MAAM;AACR,kEAAkE;GAChE,QAAQ;AACV,kEAAkE;GAChE,aAAa;AACf,kEAAkE;GAChE,MAAM,GACN,aAAa,GACb,MAAM,GACN,sBAAsB,GACtB,QAAQ,CAAC;AAEb,MAAM,MAAM,wBAAwB,GAChC,SAAS,GACT,aAAa,GACb,WAAW,GACX,WAAW,GACX,QAAQ,CAAC;AAEb,MAAM,MAAM,+BAA+B,GAAG,QAAQ,GAAG,WAAW,CAAC;AAErE,MAAM,MAAM,wBAAwB,GAChC,aAAa,GACb,OAAO,GACP,UAAU,GACV,YAAY,CAAC;AAEjB,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,wBAAwB,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,wBAAwB,CAAC;IACjC;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;;;;;;OAUG;IACH,yBAAyB,CAAC,EACtB,aAAa,GACb,UAAU,GACV,gBAAgB,GAChB,eAAe,CAAC;IACpB;;;;;;OAMG;IACH,mBAAmB,CAAC,EAChB,aAAa,GACb,wBAAwB,GACxB,wBAAwB,CAAC;IAC7B,2EAA2E;IAC3E,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,2DAA2D;IAC3D,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE;QACR,oEAAoE;QACpE,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,oEAAoE;QACpE,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB;;;WAGG;QACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;QACzB,wDAAwD;QACxD,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB;;;WAGG;QACH,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH;AAED,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,MAAM,CAAC;AAEtD,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,OAAO,GAAG,MAAM,CAAC;IAChC,yFAAyF;IACzF,YAAY,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;CAC5C;AAED,wFAAwF;AACxF,eAAO,MAAM,wBAAwB,sGAO3B,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9E,uDAAuD;AACvD,eAAO,MAAM,+BAA+B,iFAKlC,CAAC;AAEX,MAAM,MAAM,2BAA2B,GACrC,CAAC,OAAO,+BAA+B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,eAAO,MAAM,wBAAwB,0DAK3B,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9E,eAAO,MAAM,sCAAsC,kBAAkB,CAAC;AAEtE,kFAAkF;AAClF,eAAO,MAAM,+BAA+B,QAAgB,CAAC;AAE7D,0FAA0F;AAC1F,eAAO,MAAM,2BAA2B,kDAI9B,CAAC;AAEX,MAAM,MAAM,wBAAwB,GAClC,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/C,MAAM,WAAW,wBAAwB;IACvC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,qBAAqB,CAAC;IAC7B,YAAY,CAAC,EAAE,qBAAqB,CAAC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,yFAAyF;IACzF,sBAAsB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IAChE,iEAAiE;IACjE,iBAAiB,EAAE,OAAO,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,wBAAwB,CAAC;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,wBAAwB,GAAG,IAAI,CAAC;CAC1C;AAED,MAAM,WAAW,yBAAyB;IACxC,yFAAyF;IACzF,sBAAsB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IAChE,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,IAAI,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,IAAI,CAAC;IACf,sFAAsF;IACtF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,wBAAwB,GAAG,IAAI,CAAC;CAC1C;AAED,0FAA0F;AAC1F,MAAM,WAAW,yBAAyB;IACxC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kGAAkG;IAClG,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,2BAA2B;IAC1C,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACtC;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,cAAc,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kFAAkF;IAClF,WAAW,CAAC,EAAE,2BAA2B,CAAC;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE;QACV,aAAa,EAAE,+BAA+B,CAAC;QAC/C,KAAK,EAAE,sBAAsB,EAAE,CAAC;QAChC,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,gGAAgG;IAChG,YAAY,CAAC,EAAE,yBAAyB,EAAE,CAAC;IAC3C,yFAAyF;IACzF,sBAAsB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IAChE;;;;;;OAMG;IACH,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,mFAAmF;IACnF,yBAAyB,CAAC,EAAE,MAAM,EAAE,CAAC;IACrC,wEAAwE;IACxE,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC"}

package/dist/types/migration.js

@@ -0,0 +1,50 @@
+/**
+ * Wire types for the v2→v3 migration flow. Shared between the vite dev
+ * server (`vite-plugin-file-sync/src/migration/*`) and the editor UI
+ * (`ui/src/app/pages/components/migrateToV3/*`). Anything that crosses
+ * the `/sb-migration-status` boundary belongs here so a new phase or
+ * checklist field added on one side is a compile error on the other.
+ *
+ * ## State ownership (see `vite-plugin-file-sync/src/migration/README.md`)
+ *
+ * - **Server session** (`MigrationSessionResponse`): phase, generation, abort,
+ *   backup/migration/completion commit IDs. Authoritative after CP4.
+ * - **Dev-server scratch** (`MigrationStatusResponse`): checklist,
+ *   `integrationWritePolicy`, verification progress. Authoritative for in-pod work.
+ *
+ * `integrationWritePolicy` appears on both shapes for API symmetry, but only scratch
+ * is populated and enforced today. The Postgres column and `POST /migration/start`
+ * body field are schema placeholders — not part of CP1–CP4 delivery.
+ */
+/** Server-owned migration session phases (DB `application_migration_session.phase`). */
+export const MIGRATION_SESSION_PHASES = [
+    "aborting",
+    "aborted",
+    "failed",
+    "in_progress",
+    "preparing_postflip",
+    "preparing_preflip",
+];
+/** Phases that block a new `POST /migration/start`. */
+export const ACTIVE_MIGRATION_SESSION_PHASES = [
+    "aborting",
+    "in_progress",
+    "preparing_postflip",
+    "preparing_preflip",
+];
+export const MIGRATION_FAILURE_STAGES = [
+    "abort",
+    "in_progress",
+    "postflip",
+    "preflip",
+];
+export const DEFAULT_MIGRATION_TARGET_TEMPLATE_NAME = "app-fullstack";
+/** Max wall-clock time for server abort saga + UI stale detection (5 minutes). */
+export const MIGRATION_ABORT_MAX_DURATION_MS = 5 * 60 * 1000;
+/** Server abort saga resume cursor (`application_migration_session.abort_checkpoint`). */
+export const MIGRATION_ABORT_CHECKPOINTS = [
+    "requested",
+    "restored",
+    "terminated",
+];
+//# sourceMappingURL=migration.js.map

package/dist/types/migration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.js","sourceRoot":"","sources":["../../src/types/migration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAgJH,wFAAwF;AACxF,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,UAAU;IACV,SAAS;IACT,QAAQ;IACR,aAAa;IACb,oBAAoB;IACpB,mBAAmB;CACX,CAAC;AAIX,uDAAuD;AACvD,MAAM,CAAC,MAAM,+BAA+B,GAAG;IAC7C,UAAU;IACV,aAAa;IACb,oBAAoB;IACpB,mBAAmB;CACX,CAAC;AAKX,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,OAAO;IACP,aAAa;IACb,UAAU;IACV,SAAS;CACD,CAAC;AAIX,MAAM,CAAC,MAAM,sCAAsC,GAAG,eAAe,CAAC;AAEtE,kFAAkF;AAClF,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AAE7D,0FAA0F;AAC1F,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,WAAW;IACX,UAAU;IACV,YAAY;CACJ,CAAC"}

package/dist/types/mobx-shared-state.d.ts

@@ -1,9 +1,35 @@
+import type { Dim } from "../layout.js";
+import type { EntityDefinition } from "../props/prop-types.js";
+import type { SbElement } from "./common.js";
+import type { CatalogWithInternalDetails, EditorConfig } from "./register-component.js";
 export type ComponentRegistryShareState = {
     customComponentList: string[];
-    libraryComponentList: string[];
+    libraryComponentCatalogs: CatalogWithInternalDetails[];
+    libraryComponentEditorConfigs: Record<string, EditorConfig>;
+    entityDefinitions: Record<string, EntityDefinition>;
+};
+export type DndShareState = {
+    isDragging: boolean;
+    isDraggingNewComponent: boolean;
+};
+export type ResizingShareState = {
+    isResizing: boolean;
+    activeResize: null | {
+        width: Dim | null;
+        height: Dim | null;
+    };
+};
+export type ValidationState = {
+    isValid: boolean;
+    message?: string;
+    invalidValue?: any;
 };
 export type KeyToState = {
     "component-registry": ComponentRegistryShareState;
+    dnd: DndShareState;
+    resizing: ResizingShareState;
     scope: Record<string, Record<string, unknown>>;
+    validationState: Record<string, ValidationState>;
+    runtimeSync: Record<SbElement, any>;
 };
 //# sourceMappingURL=mobx-shared-state.d.ts.map

package/dist/types/mobx-shared-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mobx-shared-state.d.ts","sourceRoot":"","sources":["../../src/types/mobx-shared-state.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,2BAA2B,GAAG;IACxC,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,oBAAoB,EAAE,MAAM,EAAE,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,oBAAoB,EAAE,2BAA2B,CAAC;IAClD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAChD,CAAC"}
+{"version":3,"file":"mobx-shared-state.d.ts","sourceRoot":"","sources":["../../src/types/mobx-shared-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EACV,0BAA0B,EAC1B,YAAY,EACb,MAAM,yBAAyB,CAAC;AAEjC,MAAM,MAAM,2BAA2B,GAAG;IACxC,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,wBAAwB,EAAE,0BAA0B,EAAE,CAAC;IACvD,6BAA6B,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC5D,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CACrD,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,UAAU,EAAE,OAAO,CAAC;IACpB,sBAAsB,EAAE,OAAO,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,IAAI,GAAG;QACnB,KAAK,EAAE,GAAG,GAAG,IAAI,CAAC;QAClB,MAAM,EAAE,GAAG,GAAG,IAAI,CAAC;KACpB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,GAAG,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,oBAAoB,EAAE,2BAA2B,CAAC;IAClD,GAAG,EAAE,aAAa,CAAC;IACnB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/C,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACjD,WAAW,EAAE,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;CACrC,CAAC"}

package/dist/types/parent-messages.d.ts

@@ -1,8 +1,8 @@
+import type { BaseBlock } from "@superblocksteam/shared";
+import type { ApiRunRecord } from "./apis.js";
 import type { MobXPatch } from "./mobx-patch.js";
 import type { KeyToState } from "./mobx-shared-state.js";
 import type { AppScope } from "./scope.js";
-import type { GeneratedTheme, Theme } from "./theme.js";
-import type { BaseBlock } from "@superblocksteam/shared";
 export type DeleteMeLibraryApi = {
     apiPb: {
         metadata: {
@@ -15,8 +15,12 @@ export type DeleteMeLibraryApi = {
         };
         blocks?: BaseBlock[];
         trigger?: any;
+        authorization?: {
+            type?: "AUTHORIZATION_TYPE_APP_USERS" | "AUTHORIZATION_TYPE_JS_EXPRESSION";
+            expression?: string;
+        };
     };
-    pageName: string;
+    pageName?: string;
 };
 export type SyncStoreInitPayload<T extends keyof KeyToState = keyof KeyToState> = {
     storeId: T;
@@ -32,10 +36,6 @@ export type SyncStoreUpdatePayload<T extends keyof KeyToState> = {
  */
 export type AppToEditorMessage<PropertiesPanelDefinition> = {
     "codeMode/initScopedEntities": AppScope;
-    "codeMode/updateTheme": {
-        theme: Theme;
-        generatedTheme: GeneratedTheme;
-    };
     "codeMode/addPropertiesPanel": {
         id: string;
         definition: PropertiesPanelDefinition;
@@ -46,6 +46,15 @@ export type AppToEditorMessage<PropertiesPanelDefinition> = {
         message: string;
         description?: string;
     };
+    "codeMode/addApiRunRecord": {
+        apiId: string;
+        run: ApiRunRecord;
+    };
+    "codeMode/updateApiRunRecord": {
+        apiId: string;
+        callId: string;
+        updates: Partial<Omit<ApiRunRecord, "id" | "callId">>;
+    };
     "codeMode/editor-synced-store/update": SyncStoreUpdatePayload<keyof KeyToState>;
     "codeMode/editor-synced-store/init": SyncStoreInitPayload<keyof KeyToState>;
 };

package/dist/types/parent-messages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parent-messages.d.ts","sourceRoot":"","sources":["../../src/types/parent-messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE;QACL,QAAQ,EAAE;YACR,EAAE,EAAE,MAAM,CAAC;YACX,IAAI,EAAE,MAAM,CAAC;YACb,YAAY,EAAE,MAAM,CAAC;YACrB,UAAU,EAAE;gBAAE,OAAO,EAAE,MAAM,CAAA;aAAE,CAAC;SACjC,CAAC;QACF,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;QACrB,OAAO,CAAC,EAAE,GAAG,CAAC;KACf,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,oBAAoB,CAC9B,CAAC,SAAS,MAAM,UAAU,GAAG,MAAM,UAAU,IAC3C;IACF,OAAO,EAAE,CAAC,CAAC;IACX,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,sBAAsB,CAAC,CAAC,SAAS,MAAM,UAAU,IAAI;IAC/D,OAAO,EAAE,CAAC,CAAC;IACX,KAAK,EAAE,SAAS,GAAG,SAAS,EAAE,CAAC;CAChC,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,kBAAkB,CAAC,yBAAyB,IAAI;IAC1D,6BAA6B,EAAE,QAAQ,CAAC;IACxC,sBAAsB,EAAE;QACtB,KAAK,EAAE,KAAK,CAAC;QACb,cAAc,EAAE,cAAc,CAAC;KAChC,CAAC;IACF,6BAA6B,EAAE;QAC7B,EAAE,EAAE,MAAM,CAAC;QACX,UAAU,EAAE,yBAAyB,CAAC;KACvC,CAAC;IACF,iCAAiC,EAAE,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;IAC7E,2BAA2B,EAAE;QAC3B,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;QAC/C,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IAGF,qCAAqC,EAAE,sBAAsB,CAC3D,MAAM,UAAU,CACjB,CAAC;IACF,mCAAmC,EAAE,oBAAoB,CAAC,MAAM,UAAU,CAAC,CAAC;CAC7E,CAAC"}
+{"version":3,"file":"parent-messages.d.ts","sourceRoot":"","sources":["../../src/types/parent-messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE;QACL,QAAQ,EAAE;YACR,EAAE,EAAE,MAAM,CAAC;YACX,IAAI,EAAE,MAAM,CAAC;YACb,YAAY,EAAE,MAAM,CAAC;YACrB,UAAU,EAAE;gBAAE,OAAO,EAAE,MAAM,CAAA;aAAE,CAAC;SACjC,CAAC;QACF,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;QACrB,OAAO,CAAC,EAAE,GAAG,CAAC;QACd,aAAa,CAAC,EAAE;YACd,IAAI,CAAC,EACD,8BAA8B,GAC9B,kCAAkC,CAAC;YACvC,UAAU,CAAC,EAAE,MAAM,CAAC;SACrB,CAAC;KACH,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,oBAAoB,CAC9B,CAAC,SAAS,MAAM,UAAU,GAAG,MAAM,UAAU,IAC3C;IACF,OAAO,EAAE,CAAC,CAAC;IACX,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,sBAAsB,CAAC,CAAC,SAAS,MAAM,UAAU,IAAI;IAC/D,OAAO,EAAE,CAAC,CAAC;IACX,KAAK,EAAE,SAAS,GAAG,SAAS,EAAE,CAAC;CAChC,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,kBAAkB,CAAC,yBAAyB,IAAI;IAC1D,6BAA6B,EAAE,QAAQ,CAAC;IACxC,6BAA6B,EAAE;QAC7B,EAAE,EAAE,MAAM,CAAC;QACX,UAAU,EAAE,yBAAyB,CAAC;KACvC,CAAC;IACF,iCAAiC,EAAE,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;IAC7E,2BAA2B,EAAE;QAC3B,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;QAC/C,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,0BAA0B,EAAE;QAC1B,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,YAAY,CAAC;KACnB,CAAC;IACF,6BAA6B,EAAE;QAC7B,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC;KACvD,CAAC;IAGF,qCAAqC,EAAE,sBAAsB,CAC3D,MAAM,UAAU,CACjB,CAAC;IACF,mCAAmC,EAAE,oBAAoB,CAAC,MAAM,UAAU,CAAC,CAAC;CAC7E,CAAC"}

package/dist/types/persisted-chat-message.d.ts

@@ -0,0 +1,55 @@
+import { type AiChatMessage, type TextAttachmentType } from "./ai.js";
+/**
+ * Parsing for a persisted chat row (`chat_message.chatPayload`).
+ *
+ * Two readers load these rows: the live-edit pod's resident transcript and the
+ * editor's durable reader. The persistence filter is looser than either one --
+ * it only checks that the role and content keys exist -- while renderers call
+ * string methods on these values (`content.includes`, `group.startsWith`,
+ * `JSON.parse(content)`) and read type-specific fields without guards. So the
+ * readers, not the writer, decide what is renderable, and they have to decide
+ * it identically: a row one renders and the other drops shows up as history
+ * that appears and disappears depending on which read won.
+ *
+ * That makes this module the single definition of a renderable row. It
+ * validates required fields, normalizes optional ones to their declared types,
+ * enforces the per-type required fields, and returns a message built from a
+ * known field set rather than the raw payload.
+ */
+/** The fields a persisted row must carry to be renderable, post-normalization. */
+export type PersistedChatMessageFields = {
+    role: string;
+    content: string;
+    type: string;
+};
+export type PersistedChatMessageFieldsResult = {
+    valid: true;
+    fields: PersistedChatMessageFields;
+} | {
+    valid: false;
+    reason: "payload" | "role" | "normalizedRole" | "content" | "type";
+};
+/**
+ * Required-field contract for a persisted row. Callers own their own logging;
+ * `reason` says which field failed.
+ */
+export declare function parsePersistedChatMessageFields(payload: unknown): PersistedChatMessageFieldsResult;
+export type ParsePersistedChatMessageOptions = {
+    /**
+     * Used when the payload carries no finite timestamp of its own. Omit it to
+     * leave such a message's timestamp unset -- never NaN, which is false in
+     * every comparison and would drop the message from any windowing pass.
+     */
+    fallbackTimestamp?: number;
+    /** Called with a prefix-free reason when a row is rejected. */
+    onInvalid?: (detail: string) => void;
+    /** Called when parsing throws, so one bad row cannot fail a whole page. */
+    onError?: (error: unknown) => void;
+};
+export declare function inferTextAttachmentType(params: {
+    attachmentType: unknown;
+    mimeType: unknown;
+    fileName?: string;
+}): TextAttachmentType | null;
+export declare function parsePersistedChatMessage(payload: unknown, options: ParsePersistedChatMessageOptions): AiChatMessage | null;
+//# sourceMappingURL=persisted-chat-message.d.ts.map

package/dist/types/persisted-chat-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persisted-chat-message.d.ts","sourceRoot":"","sources":["../../src/types/persisted-chat-message.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,aAAa,EAuBlB,KAAK,kBAAkB,EACxB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;;;;GAgBG;AAEH,kFAAkF;AAClF,MAAM,MAAM,0BAA0B,GAAG;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,gCAAgC,GACxC;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,0BAA0B,CAAA;CAAE,GACnD;IACE,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,gBAAgB,GAAG,SAAS,GAAG,MAAM,CAAC;CACpE,CAAC;AA4CN;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,OAAO,GACf,gCAAgC,CA2BlC;AAED,MAAM,MAAM,gCAAgC,GAAG;IAC7C;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,+DAA+D;IAC/D,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,2EAA2E;IAC3E,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACpC,CAAC;AA0CF,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC9C,cAAc,EAAE,OAAO,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,kBAAkB,GAAG,IAAI,CAgE5B;AA6JD,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,gCAAgC,GACxC,aAAa,GAAG,IAAI,CA4ftB"}