@8wave/ai-elements 0.84.0 → 0.85.0

package/README.md

@@ -139,6 +139,86 @@ widget.setAttribute('external-token', jwt) // Single session created
 | `forwarded-slots`   | `string` | ❌       | —                               | Comma-separated slot names to forward to `PkChatbot` (e.g. `"tool-showArtifact,subagent"`).         |
 | `custom-css`        | `string` | ❌       | —                               | Raw CSS string injected into the shadow root to override default styles.                             |
 
+## JavaScript API
+
+Both custom elements expose an imperative JavaScript API on their DOM node. Methods and properties are available once the element is connected to the DOM.
+
+### `<floating-chat-widget>` methods
+
+| Method / Property | Signature                          | Description                                                                 |
+| ----------------- | ---------------------------------- | --------------------------------------------------------------------------- |
+| `open()`          | `() => void`                       | Opens the chat panel. No-op if already open.                                |
+| `close()`         | `() => void`                       | Closes the chat panel. No-op if already closed.                             |
+| `toggle()`        | `() => void`                       | Toggles the chat panel open/closed.                                         |
+| `sendMessage(text)` | `(text: string) => void`         | Programmatically sends a user message. The widget must be `ready` (see events). |
+| `setContext(ctx)` | `(ctx: Record<string, unknown>) => void` | Sets external context data forwarded to the LLM on every subsequent message. |
+| `isOpen`          | `boolean` (getter)                 | Returns `true` if the chat panel is currently visible.                      |
+
+### `<embedded-chat-widget>` methods
+
+| Method / Property | Signature                          | Description                                                                 |
+| ----------------- | ---------------------------------- | --------------------------------------------------------------------------- |
+| `sendMessage(text)` | `(text: string) => void`         | Programmatically sends a user message. The widget must be `ready` (see events). |
+| `setContext(ctx)` | `(ctx: Record<string, unknown>) => void` | Sets external context data forwarded to the LLM on every subsequent message. |
+
+### DOM Events
+
+Both elements dispatch standard `CustomEvent`s that bubble and cross shadow DOM boundaries (`composed: true`). Listen for them on the element instance or any ancestor:
+
+| Event    | `detail`                                              | Description                                                |
+| -------- | ----------------------------------------------------- | ---------------------------------------------------------- |
+| `ready`  | `null`                                                | Session is authenticated and the widget can accept messages. |
+| `error`  | `{ type: string, title: string, status: number }`    | An authentication or API error occurred.                   |
+| `opened` | `null`                                                | Chat panel was opened (floating widget only).              |
+| `closed` | `null`                                                | Chat panel was closed (floating widget only).              |
+
+### Example: open widget and send a message
+
+```js
+const widget = document.querySelector('floating-chat-widget')
+
+widget.addEventListener('ready', () => {
+  // Provide contextual data from your application
+  widget.setContext({ userId: '42', plan: 'pro', cartTotal: 129.90 })
+
+  // Open the panel and greet the user
+  widget.open()
+  widget.sendMessage('Hello! I have a question about pricing.')
+})
+```
+
+### External Context (`setContext`)
+
+`setContext(ctx)` allows the host page to inject structured data that gets forwarded to the AI model as part of the system prompt. This enables personalized, context-aware responses without polluting the chat history.
+
+**Security model:**
+- The agent administrator defines an `externalContextSchema` (JSON Schema) in the agent settings.
+- The backend validates incoming context against this schema — only declared fields are forwarded.
+- If no schema is configured on the agent, all external context is silently ignored (deny-by-default).
+
+**Behavior:**
+- Context is sent with every subsequent message — call `setContext()` before or between messages.
+- Values are snapshotted per-message and persisted in the message metadata (visible in the backoffice).
+- Calling `setContext()` replaces the previous context entirely (not merged).
+
+```js
+// Set context once on page load
+widget.setContext({
+  userName: 'Mario Rossi',
+  plan: 'enterprise',
+  cartItems: 3,
+  accountBalance: 250.00,
+})
+
+// Update it when something changes (e.g. after a purchase)
+widget.setContext({
+  userName: 'Mario Rossi',
+  plan: 'enterprise',
+  cartItems: 0,
+  accountBalance: 120.10,
+})
+```
+
 ## How it works
 
 1. On mount the component automatically signs in as an anonymous user via the Eight Wave Auth service.
@@ -147,6 +227,32 @@ widget.setAttribute('external-token', jwt) // Single session created
 4. Clicking the button toggles the chat panel open/closed.
 5. All styles are encapsulated inside a Shadow DOM — no CSS leaks in or out.
 
+## TypeScript Support
+
+The package ships type declarations for both custom elements. When you `import '@8wave/ai-elements'`, the following global augmentations are available:
+
+- **`HTMLElementTagNameMap`** — `document.querySelector()` and `document.createElement()` return correctly typed elements with all properties and methods.
+- **`GlobalComponents` (Vue)** — props are type-checked and autocompleted in Vue templates.
+
+```ts
+// Vanilla TS
+const widget = document.querySelector('floating-chat-widget')
+//    ^? FloatingChatWidgetElement
+
+widget.toggle()          // ✅ typed
+widget.isOpen            // ✅ boolean
+widget.sendMessage('hi') // ✅ typed
+```
+
+### Exported interfaces
+
+| Interface                      | Extends       | Description                                      |
+| ------------------------------ | ------------- | ------------------------------------------------ |
+| `FloatingChatWidgetElement`    | `HTMLElement` | DOM interface for `<floating-chat-widget>`.      |
+| `EmbeddedChatWidgetElement`    | `HTMLElement` | DOM interface for `<embedded-chat-widget>`.      |
+
+Both interfaces include all attributes (as properties) and the imperative JavaScript API methods documented above.
+
 ## Vue Components
 
 In addition to the web component, the package exposes all `Pk*` Vue 3 components for direct use inside Vue applications.
@@ -230,6 +336,7 @@ import PkChatbot from '@8wave/ai-elements/vue/PkChatbot'
 | `agentFileUpload` | `AgentFileUpload`                     | ❌       | File upload configuration (accepted types, size limits).       |
 | `fallbackModels`  | `string[]`                            | ❌       | Ordered list of fallback model identifiers.                    |
 | `gatewayOptions`  | `Partial<AgentGatewayOptions>`        | ❌       | Gateway-level options (routing, caching, etc.).                |
+| `externalContext` | `Record<string, unknown>`             | ❌       | External context data injected into the system prompt (validated server-side). |
 
 ### `PkChatbot` v-model
 
@@ -560,6 +667,7 @@ store.navigate('conversations')
 | `pendingAttachments`   | `Ref<PendingAttachment[]>`      | Files queued for upload or already uploaded.                       |
 | `isConversationBlocked`| `Ref<boolean>`                  | Whether the current conversation is blocked.                      |
 | `chatError`            | `Ref<Error \| undefined>`      | Latest chat error, if any.                                        |
+| `externalContext`      | `Ref<Record<string, unknown> \| undefined>` | External context to inject into the system prompt.       |
 | `isLeadSubmitted`      | `Ref<boolean>`                  | Whether the lead form was submitted successfully.                 |
 | `messageFeedbacks`     | `Ref<MessageFeedback[]>`        | Feedback entries for the current conversation.                    |
 
@@ -570,6 +678,7 @@ store.navigate('conversations')
 | `initialize`           | `(agentId, chatId) => Promise<void>`             | Loads conversation, feedbacks, and agent config.                  |
 | `loadConversations`    | `(agentId) => Promise<void>`                     | Fetches the conversation list for the agent.                      |
 | `handleSubmit`         | `(options?) => Promise<void>`                    | Sends the current input as a message.                             |
+| `sendMessage`          | `(text: string) => void`                         | Programmatically sends a user message (no input snapshot/rollback). |
 | `stopGeneration`       | `() => Promise<void>`                            | Aborts the current streaming response.                            |
 | `startNewChat`         | `() => Promise<string>`                          | Clears state and generates a new chat ID.                         |
 | `regenerate`           | `(options?) => Promise<void>`                    | Regenerates the last assistant response.                          |

package/dist/_chunks/Media-Cu3QLEp0.js

@@ -0,0 +1,120 @@
+import { T as e, a as t, b as n, c as r, d as i, g as a, m as o, n as s, o as c, p as l, s as u, t as d, v as f, x as p, y as m } from "./schemas-CzYlXub_.js";
+//#region ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/classic/coerce.js
+function h(t) {
+	return e(d, t);
+}
+//#endregion
+//#region ../../packages/models/src/utils.ts
+var g = 50 * 1024, _ = a(f(), n()).refine((e) => JSON.stringify(e).length <= g, { message: `Schema must not exceed ${g / 1024} KB` }), v = (e) => [`${e}`, `-${e}`], y = (e) => e.flatMap((e) => v(e)), b = {
+	pagination: (e = 1, t = 10) => ({
+		"page[number]": l().or(f()).transform((e) => Number(e)).default(e),
+		"page[size]": l().or(f()).transform((e) => Number(e)).default(t)
+	}),
+	filter: (e) => ({ [`filter[${e}]`]: f().optional() }),
+	include: (e) => ({ [`include[${e}]`]: f().optional() }),
+	range: (e) => ({
+		[`from[${e}]`]: f().optional(),
+		[`to[${e}]`]: f().optional()
+	}),
+	has: (e) => ({ [`has[${e}]`]: c().optional() }),
+	fullText: () => ({ "filter[fullText]": f().optional() }),
+	ids: () => ({ ids: m([f(), t(f())]).optional() }),
+	deleted: () => ({ "filter[isDeleted]": c().default(!1) }),
+	filters: (e) => e.map((e) => b.filter(e)).reduce((e, t) => ({
+		...e,
+		...t
+	})),
+	sort: (e) => {
+		let t = y(e);
+		return { sort: s(t).optional().default(t[0]) };
+	}
+}, x = /* @__PURE__ */ function(e) {
+	return e.textEmbedding3Small = "openai/text-embedding-3-small", e.gpt5Nano = "openai/gpt-5-nano", e.gpt5Mini = "openai/gpt-5-mini", e.gpt51Thinking = "openai/gpt-5.1-thinking", e.gpt51Instant = "openai/gpt-5.1-instant", e.gpt52 = "openai/gpt-5.2", e.gpt52Chat = "openai/gpt-5.2-chat", e.gpt54nano = "openai/gpt-5.4-nano", e.gpt54mini = "openai/gpt-5.4-mini", e.gpt54 = "openai/gpt-5.4", e.gpt54Pro = "openai/gpt-5.4-pro", e.gpt55 = "openai/gpt-5.5", e.gpt55Pro = "openai/gpt-5.5-pro", e.gemini25Flash = "google/gemini-2.5-flash", e.gemini25FlashLite = "google/gemini-2.5-flash-lite", e.gemini25Pro = "google/gemini-2.5-pro", e.gemini3Flash = "google/gemini-3-flash", e.gemini3ProPreview = "google/gemini-3-pro-preview", e.gemini31FlashLitePreview = "google/gemini-3.1-flash-lite-preview", e.gemini31ProPreview = "google/gemini-3.1-pro-preview", e.gemini31FlashLite = "google/gemini-3.1-flash-lite", e.gemini35Flash = "google/gemini-3.5-flash", e.claudeHaiku45 = "anthropic/claude-haiku-4.5", e.claudeSonnet45 = "anthropic/claude-sonnet-4.5", e.claudeSonnet46 = "anthropic/claude-sonnet-4.6", e.claudeOpus46 = "anthropic/claude-opus-4.6", e.claudeOpus47 = "anthropic/claude-opus-4.7", e.claudeOpus48 = "anthropic/claude-opus-4.8", e.deepseek32 = "deepseek/deepseek-v3.2", e.deepseek32Thinking = "deepseek/deepseek-v3.2-thinking", e.deepseek4pro = "deepseek/deepseek-v4-pro", e.deepseek4Flash = "deepseek/deepseek-v4-flash", e.alibabaQwen36Plus = "alibaba/qwen3.6-plus", e.xaiGrok43 = "xai/grok-4.3", e;
+}({});
+x.textEmbedding3Small;
+var S = /* @__PURE__ */ function(e) {
+	return e.it = "it", e.en = "en", e.es = "es", e.fr = "fr", e.de = "de", e;
+}({});
+S.it, S.en, S.es, S.fr, S.de;
+var C = /* @__PURE__ */ function(e) {
+	return e.READABILITY = "readability", e.AI = "ai", e;
+}({}), w = /* @__PURE__ */ function(e) {
+	return e.FETCH = "fetch", e.PUPPETEER = "puppeteer", e.REMOTE = "remote", e;
+}({}), T = /^[a-z]+\/[a-z0-9\-+.]+$/i, E = /* @__PURE__ */ function(e) {
+	return e.DEFAULT = "default", e.COLD = "cold", e.HOT = "hot", e.ARCHIVE = "archive", e;
+}({}), D = r("type", [o({
+	type: i("azure-blob"),
+	blobUri: p(),
+	containerName: f().min(1),
+	pathRelativeToContainer: f().min(1)
+}), o({
+	type: i("s3"),
+	bucket: f().min(1),
+	key: f().min(1),
+	region: f().min(1)
+})]), O = o({
+	type: f().min(1),
+	name: f().min(1),
+	mimeType: f().regex(T),
+	bytesCount: l().positive(),
+	extension: f().regex(/^\.[a-zA-Z0-9]+$/).transform((e) => e.toLowerCase()),
+	storedFileName: f().optional(),
+	metadata: a(f(), f()).default({}),
+	tags: a(f(), f()).default({})
+}).extend({
+	storageHandle: D,
+	storagePolicy: s(E),
+	signData: f().optional(),
+	storedFileName: f().min(1)
+}), k = o({
+	name: f().min(1),
+	src: O,
+	srcSet: t(O).default([]),
+	rawOptions: u().optional()
+});
+o({
+	src: O,
+	uploadHandle: o({
+		uploadSasuri: p(),
+		metadata: a(f(), f()).default({}),
+		tags: a(f(), f()).default({})
+	})
+}), o({
+	src: O,
+	downloadHandle: o({
+		downloadSasuri: p(),
+		viewSasuri: p(),
+		previewSasuri: p().optional(),
+		expiresOn: f().datetime(),
+		type: f()
+	})
+});
+var A = /* @__PURE__ */ function(e) {
+	return e.picture = "picture", e.video = "video", e.audio = "audio", e.office = "office", e.archive = "archive", e.binary = "binary", e.executable = "executable", e;
+}({});
+r("type", [
+	o({
+		type: i(A.picture),
+		width: l().positive(),
+		height: l().positive(),
+		blurhash: f().optional()
+	}),
+	o({
+		type: i(A.video),
+		width: l().positive(),
+		height: l().positive(),
+		duration: l().nonnegative()
+	}),
+	o({
+		type: i(A.audio),
+		duration: l().nonnegative()
+	}),
+	o({ type: i(A.office) }),
+	o({ type: i(A.archive) }),
+	o({ type: i(A.binary) }),
+	o({ type: i(A.executable) })
+]);
+//#endregion
+export { x as a, b as c, C as i, h as l, k as n, S as o, w as r, _ as s, T as t };
+
+//# sourceMappingURL=Media-Cu3QLEp0.js.map

package/dist/_chunks/Media-Cu3QLEp0.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Media-Cu3QLEp0.js","names":["core._coercedDate","schemas.ZodDate"],"sources":["../../../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/classic/coerce.js","../../../../packages/models/src/utils.ts","../../../../packages/models/src/schema/constants.ts","../../../../packages/models/src/schema/Media.ts"],"sourcesContent":["import * as core from \"../core/index.js\";\nimport * as schemas from \"./schemas.js\";\nexport function string(params) {\n    return core._coercedString(schemas.ZodString, params);\n}\nexport function number(params) {\n    return core._coercedNumber(schemas.ZodNumber, params);\n}\nexport function boolean(params) {\n    return core._coercedBoolean(schemas.ZodBoolean, params);\n}\nexport function bigint(params) {\n    return core._coercedBigint(schemas.ZodBigInt, params);\n}\nexport function date(params) {\n    return core._coercedDate(schemas.ZodDate, params);\n}\n","import * as z from 'zod'\n\nconst MAX_SCHEMA_SIZE_BYTES = 50 * 1024 // 50 KB\n\n/** Reusable Zod field for JSON Schema objects with a 50 KB size limit. */\nexport const jsonSchemaField = z\n    .record(z.string(), z.unknown())\n    .refine((val) => JSON.stringify(val).length <= MAX_SCHEMA_SIZE_BYTES, {\n        message: `Schema must not exceed ${MAX_SCHEMA_SIZE_BYTES / 1024} KB`,\n    })\n\nexport type QueryStringFilter<T extends string = string> = `filter[${T}]`\nexport type Querystring = {\n    'page[number]'?: number | string\n    'page[size]'?: number | string\n    sort?: string[] | string\n    [filterKeys: QueryStringFilter]: unknown\n    [otherKeys: string]: unknown\n}\n\nexport const makeSortEnum = <const T extends string>(input: T) => {\n    return [`${input}`, `-${input}`] as [T, `-${T}`]\n}\n\nexport const makeSortEnums = <const T extends string>(input: readonly T[]) => {\n    return input.flatMap((i) => makeSortEnum(i))\n}\n\nexport const zodQs = {\n    pagination: (defaultNumber = 1, defaultSize = 10) => {\n        return {\n            'page[number]': z\n                .number()\n                .or(z.string())\n                .transform((v) => Number(v))\n                .default(defaultNumber),\n            'page[size]': z\n                .number()\n                .or(z.string())\n                .transform((v) => Number(v))\n                .default(defaultSize),\n        }\n    },\n    filter: <const T extends string>(input: T) => {\n        return { [`filter[${input}]`]: z.string().optional() } as Record<\n            `filter[${T}]`,\n            z.ZodOptional<z.ZodString | z.ZodArray<z.ZodString>>\n        >\n    },\n    include: <const T extends string>(input: T) => {\n        return { [`include[${input}]`]: z.string().optional() } as Record<\n            `include[${T}]`,\n            z.ZodOptional<z.ZodArray<z.ZodString> | z.ZodString>\n        >\n    },\n    range: <const T extends string>(input: T) => {\n        return {\n            [`from[${input}]`]: z.string().optional(),\n            [`to[${input}]`]: z.string().optional(),\n        } as Record<`from[${T}]` | `to[${T}]`, z.ZodOptional<z.ZodString>>\n    },\n    has: <const T extends string>(input: T) => {\n        return { [`has[${input}]`]: z.boolean().optional() } as Record<\n            `has[${T}]`,\n            z.ZodOptional<z.ZodBoolean>\n        >\n    },\n    fullText: () => {\n        return { [`filter[fullText]`]: z.string().optional() }\n    },\n    ids: () => {\n        return { ids: z.union([z.string(), z.array(z.string())]).optional() }\n    },\n    deleted: () => {\n        return { 'filter[isDeleted]': z.boolean().default(false) }\n    },\n    filters: <const T extends string>(input: readonly T[]) => {\n        return input\n            .map((i) => zodQs.filter(i))\n            .reduce((a, b) => ({ ...a, ...b }))\n    },\n    sort: <const S extends string>(sort: S[]) => {\n        const sortEnums = makeSortEnums(sort) as [S, ...`-${S}`[]]\n        return {\n            // @ts-expect-error: zod does not support tuple types\n            sort: z.enum(sortEnums).optional().default(sortEnums[0]),\n        }\n    },\n}\n","export enum LanguageModel {\n    // OpenAI\n    textEmbedding3Small = 'openai/text-embedding-3-small',\n    gpt5Nano = 'openai/gpt-5-nano',\n    gpt5Mini = 'openai/gpt-5-mini',\n    gpt51Thinking = 'openai/gpt-5.1-thinking',\n    gpt51Instant = 'openai/gpt-5.1-instant',\n    gpt52 = 'openai/gpt-5.2',\n    gpt52Chat = 'openai/gpt-5.2-chat',\n    gpt54nano = 'openai/gpt-5.4-nano',\n    gpt54mini = 'openai/gpt-5.4-mini',\n    gpt54 = 'openai/gpt-5.4',\n    gpt54Pro = 'openai/gpt-5.4-pro',\n    gpt55 = 'openai/gpt-5.5',\n    gpt55Pro = 'openai/gpt-5.5-pro',\n    // Google Gemini\n    gemini25Flash = 'google/gemini-2.5-flash',\n    gemini25FlashLite = 'google/gemini-2.5-flash-lite',\n    gemini25Pro = 'google/gemini-2.5-pro',\n    gemini3Flash = 'google/gemini-3-flash',\n    gemini3ProPreview = 'google/gemini-3-pro-preview',\n    gemini31FlashLitePreview = 'google/gemini-3.1-flash-lite-preview',\n    gemini31ProPreview = 'google/gemini-3.1-pro-preview',\n    gemini31FlashLite = 'google/gemini-3.1-flash-lite',\n    gemini35Flash = 'google/gemini-3.5-flash',\n    // Anthropic Claude\n    claudeHaiku45 = 'anthropic/claude-haiku-4.5',\n    claudeSonnet45 = 'anthropic/claude-sonnet-4.5',\n    claudeSonnet46 = 'anthropic/claude-sonnet-4.6',\n    claudeOpus46 = 'anthropic/claude-opus-4.6',\n    claudeOpus47 = 'anthropic/claude-opus-4.7',\n    claudeOpus48 = 'anthropic/claude-opus-4.8',\n    // Deepseek\n    deepseek32 = 'deepseek/deepseek-v3.2',\n    deepseek32Thinking = 'deepseek/deepseek-v3.2-thinking',\n    deepseek4pro = 'deepseek/deepseek-v4-pro',\n    deepseek4Flash = 'deepseek/deepseek-v4-flash',\n    // Alibaba\n    alibabaQwen36Plus = 'alibaba/qwen3.6-plus',\n    // xAI\n    xaiGrok43 = 'xai/grok-4.3',\n}\n\nexport const EMBED_MODEL = LanguageModel.textEmbedding3Small\n\nexport enum LanguageModelBrand {\n    openai = 'openai',\n    google = 'google',\n    anthropic = 'anthropic',\n    deepseek = 'deepseek',\n    xai = 'xai',\n}\n\n/**\n * Supported languages for documents and revised answers\n */\nexport enum SupportedLanguage {\n    it = 'it',\n    en = 'en',\n    es = 'es',\n    fr = 'fr',\n    de = 'de',\n}\n\n/**\n * Language display names (i18n keys)\n */\nexport const LANGUAGE_NAMES: Record<SupportedLanguage, string> = {\n    [SupportedLanguage.it]: 'language.italian',\n    [SupportedLanguage.en]: 'language.english',\n    [SupportedLanguage.es]: 'language.spanish',\n    [SupportedLanguage.fr]: 'language.french',\n    [SupportedLanguage.de]: 'language.german',\n}\n\n/**\n * Content extraction strategies for URL scraping\n */\nexport enum ExtractionStrategy {\n    /** Use Mozilla Readability for content extraction (fast, free, no API calls) */\n    READABILITY = 'readability',\n    /** Use AI-based extraction (better for complex layouts, requires API calls) */\n    AI = 'ai',\n}\n\n/**\n * Browser engine options for URL scraping\n */\nexport enum BrowserEngine {\n    /** Use simple HTTP fetch (fast, lightweight, no JavaScript support) */\n    FETCH = 'fetch',\n    /** Use Puppeteer with headless Chrome (full browser, JavaScript support) */\n    PUPPETEER = 'puppeteer',\n    /** Delegate browser rendering to an external pdf-image-generator service */\n    REMOTE = 'remote',\n}\n","import { z } from 'zod'\n\n// ===== Constants =====\n\nexport const MAX_FILE_SIZE = 100 * 1024 * 1024 // 100MB\n\nexport const MIME_TYPE_REGEX = /^[a-z]+\\/[a-z0-9\\-+.]+$/i\n\nexport const SUPPORTED_IMAGE_TYPES = [\n    'image/jpeg',\n    'image/png',\n    'image/gif',\n    'image/webp',\n    'image/svg+xml',\n] as const\n\nexport const SUPPORTED_DOCUMENT_TYPES = [\n    'application/pdf',\n    'application/msword',\n    'application/vnd.openxmlformats-officedocument.wordprocessingml.document',\n    'application/vnd.ms-excel',\n    'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',\n    'text/plain',\n    'text/markdown',\n] as const\n\nexport const SUPPORTED_VIDEO_TYPES = [\n    'video/mp4',\n    'video/webm',\n    'video/ogg',\n] as const\n\nexport const SUPPORTED_AUDIO_TYPES = [\n    'audio/mpeg',\n    'audio/wav',\n    'audio/ogg',\n] as const\n\n// ===== Enums =====\n\nexport enum StoragePolicy {\n    DEFAULT = 'default',\n    COLD = 'cold',\n    HOT = 'hot',\n    ARCHIVE = 'archive',\n}\n\nexport enum PreviewStatus {\n    Pending = 'pending',\n    Done = 'done',\n    Failed = 'failed',\n}\n\n// ===== Storage Handle Schemas =====\n\nconst AzureBlobStorageHandleSchema = z.object({\n    type: z.literal('azure-blob'),\n    blobUri: z.url(),\n    containerName: z.string().min(1),\n    pathRelativeToContainer: z.string().min(1),\n})\n\nconst S3StorageHandleSchema = z.object({\n    type: z.literal('s3'),\n    bucket: z.string().min(1),\n    key: z.string().min(1),\n    region: z.string().min(1),\n})\n\nconst StorageHandleSchema = z.discriminatedUnion('type', [\n    AzureBlobStorageHandleSchema,\n    S3StorageHandleSchema,\n])\n\n// ===== Media Upload Schema =====\n\n/**\n * Media upload information for preparing a file upload\n */\nexport const MediaUploadSchema = z.object({\n    /** Media type category (picture, video, audio, etc.) */\n    type: z.string().min(1),\n    /** Original filename */\n    name: z.string().min(1),\n    /** MIME type (e.g., 'image/jpeg') */\n    mimeType: z.string().regex(MIME_TYPE_REGEX),\n    /** File size in bytes (must be positive) */\n    bytesCount: z.number().positive(),\n    /** File extension with dot (e.g., '.jpg') */\n    extension: z\n        .string()\n        .regex(/^\\.[a-zA-Z0-9]+$/)\n        .transform((ext) => ext.toLowerCase()),\n    /** Optional custom stored filename */\n    storedFileName: z.string().optional(),\n    /** Additional metadata key-value pairs */\n    metadata: z.record(z.string(), z.string()).default({}),\n    /** Storage tags for categorization */\n    tags: z.record(z.string(), z.string()).default({}),\n})\nexport type MediaUpload = z.infer<typeof MediaUploadSchema>\n\n// ===== Media Source Schema =====\n\n/**\n * Complete media source information including storage details\n */\nexport const MediaSourceSchema = MediaUploadSchema.extend({\n    /** Storage backend configuration */\n    storageHandle: StorageHandleSchema,\n    /** Storage tier/policy */\n    storagePolicy: z.enum(StoragePolicy),\n    /** Optional signature data for verification */\n    signData: z.string().optional(),\n    /** Actual stored filename (required) */\n    storedFileName: z.string().min(1),\n})\nexport type MediaSource = z.infer<typeof MediaSourceSchema>\n\n// ===== Media Schema =====\n\n/**\n * Complete media object with source and optional variants\n */\nexport const MediaSchema = z.object({\n    /** Display name for the media */\n    name: z.string().min(1),\n    /** Primary media source */\n    src: MediaSourceSchema,\n    /** Optional additional sources (e.g., different resolutions) */\n    srcSet: z.array(MediaSourceSchema).default([]),\n    /** Type-specific metadata (dimensions, duration, etc.) */\n    rawOptions: z.custom<RawOptions>().optional(),\n})\nexport type Media = z.infer<typeof MediaSchema>\n\n// ===== Upload Handle Schema =====\n\n/**\n * Upload handle containing SAS URI and metadata for client-side upload\n */\nexport const MediaUploadHandleSchema = z.object({\n    /** Media source information */\n    src: MediaSourceSchema,\n    /** Upload credentials and metadata */\n    uploadHandle: z.object({\n        /** Shared Access Signature URI for upload */\n        uploadSasuri: z.url(),\n        /** Metadata to attach to the blob */\n        metadata: z.record(z.string(), z.string()).default({}),\n        /** Tags to attach to the blob */\n        tags: z.record(z.string(), z.string()).default({}),\n    }),\n})\nexport type MediaUploadHandle = z.infer<typeof MediaUploadHandleSchema>\n\n// ===== Download Handle Schema =====\n\n/**\n * Download handle containing SAS URIs for different access patterns\n */\nexport const MediaDownloadHandleSchema = z.object({\n    /** Media source information */\n    src: MediaSourceSchema,\n    /** Download credentials and URIs */\n    downloadHandle: z.object({\n        /** SAS URI for file download */\n        downloadSasuri: z.url(),\n        /** SAS URI for inline viewing */\n        viewSasuri: z.url(),\n        /** Optional SAS URI for preview thumbnail */\n        previewSasuri: z.url().optional(),\n        /** Expiration timestamp for the SAS URIs */\n        expiresOn: z.string().datetime(),\n        /** Storage backend type */\n        type: z.string(),\n    }),\n})\nexport type MediaDownloadHandle = z.infer<typeof MediaDownloadHandleSchema>\n\n// ===== Media Types =====\n\nexport enum MediaType {\n    picture = 'picture',\n    video = 'video',\n    audio = 'audio',\n    office = 'office',\n    archive = 'archive',\n    binary = 'binary',\n    executable = 'executable',\n}\n\n// ===== Raw Options Schemas =====\n\nconst PictureRawOptionsSchema = z.object({\n    type: z.literal(MediaType.picture),\n    width: z.number().positive(),\n    height: z.number().positive(),\n    blurhash: z.string().optional(),\n})\n\nconst VideoRawOptionsSchema = z.object({\n    type: z.literal(MediaType.video),\n    width: z.number().positive(),\n    height: z.number().positive(),\n    duration: z.number().nonnegative(),\n})\n\nconst AudioRawOptionsSchema = z.object({\n    type: z.literal(MediaType.audio),\n    duration: z.number().nonnegative(),\n})\n\nconst OfficeRawOptionsSchema = z.object({\n    type: z.literal(MediaType.office),\n})\n\nconst ArchiveRawOptionsSchema = z.object({\n    type: z.literal(MediaType.archive),\n})\n\nconst BinaryRawOptionsSchema = z.object({\n    type: z.literal(MediaType.binary),\n})\n\nconst ExecutableRawOptionsSchema = z.object({\n    type: z.literal(MediaType.executable),\n})\n\nexport const RawOptionsSchema = z.discriminatedUnion('type', [\n    PictureRawOptionsSchema,\n    VideoRawOptionsSchema,\n    AudioRawOptionsSchema,\n    OfficeRawOptionsSchema,\n    ArchiveRawOptionsSchema,\n    BinaryRawOptionsSchema,\n    ExecutableRawOptionsSchema,\n])\n\n// ===== Raw Options Types =====\n\n// ===== Raw Options Types =====\n\nexport type PictureRawOptions = z.infer<typeof PictureRawOptionsSchema>\nexport type VideoRawOptions = z.infer<typeof VideoRawOptionsSchema>\nexport type AudioRawOptions = z.infer<typeof AudioRawOptionsSchema>\nexport type OfficeRawOptions = z.infer<typeof OfficeRawOptionsSchema>\nexport type ArchiveRawOptions = z.infer<typeof ArchiveRawOptionsSchema>\nexport type BinaryRawOptions = z.infer<typeof BinaryRawOptionsSchema>\nexport type ExecutableRawOptions = z.infer<typeof ExecutableRawOptionsSchema>\n\nexport type RawOptions = z.infer<typeof RawOptionsSchema>\n\n// ===== Uploaded File Type =====\n\nexport type UploadedFile<Source = undefined> = Source extends undefined\n    ? {\n          name: string\n          size: number\n          type: string\n          url: string\n          lastModified?: number\n      }\n    : {\n          name: string\n          size: number\n          type: string\n          url: string\n          lastModified?: number\n          source: Source\n      }\n\n// ===== Helper Functions =====\n\n/**\n * Check if a MIME type is a supported image format\n */\nexport const isSupportedImageType = (mimeType: string): boolean => {\n    return mimeType.startsWith('image/')\n}\n\n/**\n * Check if a MIME type supports preview generation\n */\nexport const isSupportedPreviewType = (mimeType: string): boolean => {\n    return mimeType.startsWith('image/') || mimeType === 'application/pdf'\n}\n\n/**\n * Determine MediaType from MIME type\n */\nexport const getMediaTypeFromMime = (mimeType: string): MediaType => {\n    if (mimeType.startsWith('image/')) return MediaType.picture\n    if (mimeType.startsWith('video/')) return MediaType.video\n    if (mimeType.startsWith('audio/')) return MediaType.audio\n    if (\n        mimeType.startsWith('application/pdf') ||\n        mimeType.startsWith('application/msword') ||\n        mimeType.startsWith('application/vnd.openxmlformats') ||\n        mimeType.startsWith('application/vnd.ms-')\n    ) {\n        return MediaType.office\n    }\n    if (\n        mimeType === 'application/zip' ||\n        mimeType === 'application/x-rar-compressed' ||\n        mimeType === 'application/x-7z-compressed'\n    ) {\n        return MediaType.archive\n    }\n    if (\n        mimeType.startsWith('application/x-') &&\n        mimeType.includes('executable')\n    ) {\n        return MediaType.executable\n    }\n    return MediaType.binary\n}\n\n/**\n * Extract file extension from filename\n */\nexport const getExtensionFromFilename = (filename: string): string => {\n    const lastDot = filename.lastIndexOf('.')\n    return lastDot === -1 ? '' : filename.slice(lastDot).toLowerCase()\n}\n\n/**\n * Format bytes to human-readable string\n */\nexport const formatBytes = (bytes: number, decimals = 2): string => {\n    if (bytes === 0) return '0 Bytes'\n    const k = 1024\n    const dm = decimals < 0 ? 0 : decimals\n    const sizes = ['Bytes', 'KB', 'MB', 'GB', 'TB']\n    const i = Math.floor(Math.log(bytes) / Math.log(k))\n    return `${parseFloat((bytes / Math.pow(k, i)).toFixed(dm))} ${sizes[i]}`\n}\n\n// ===== Type Guards =====\n\nexport const isPictureOptions = (\n    options: RawOptions,\n): options is PictureRawOptions => {\n    return options.type === MediaType.picture\n}\n\nexport const isVideoOptions = (\n    options: RawOptions,\n): options is VideoRawOptions => {\n    return options.type === MediaType.video\n}\n\nexport const isAudioOptions = (\n    options: RawOptions,\n): options is AudioRawOptions => {\n    return options.type === MediaType.audio\n}\n\nexport const isOfficeOptions = (\n    options: RawOptions,\n): options is OfficeRawOptions => {\n    return options.type === MediaType.office\n}\n\nexport const isArchiveOptions = (\n    options: RawOptions,\n): options is ArchiveRawOptions => {\n    return options.type === MediaType.archive\n}\n\nexport const isBinaryOptions = (\n    options: RawOptions,\n): options is BinaryRawOptions => {\n    return options.type === MediaType.binary\n}\n\nexport const isExecutableOptions = (\n    options: RawOptions,\n): options is ExecutableRawOptions => {\n    return options.type === MediaType.executable\n}\n"],"x_google_ignoreList":[0],"mappings":"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"}