@w3kits/sdk 0.1.0

package/dist/profile-app-file.d.ts

@@ -0,0 +1,202 @@
+export declare const DEFAULT_PLUGIN_PROFILE_ID = "default";
+export declare const PROFILE_APP_SCHEMA_VERSION = 1;
+export declare const PROFILE_VISIBLE_ROOT = "/home/agent";
+export interface ProfileAppPluginConfigFile {
+    path: string;
+    content: string;
+    overwrite?: boolean;
+}
+export interface ProfileAppPackageDescriptor {
+    name?: string;
+    version?: string;
+    registry?: string;
+    tarball?: string;
+    integrity?: string;
+    provenance?: boolean;
+}
+export interface ProfileAppPluginRuntime {
+    type: string;
+    configFiles?: ProfileAppPluginConfigFile[];
+    bundle_url?: string;
+    sha256?: string;
+    assetBaseUrl?: string;
+}
+export interface ProfileAppPluginDesktop {
+    defaultWidth: number;
+    defaultHeight: number;
+    minWidth?: number;
+    minHeight?: number;
+}
+export interface ProfileAppPluginDescriptor {
+    slug: string;
+    name: string;
+    description?: string;
+    version: string;
+    commitHash: string;
+    entryUrl: string;
+    iconUrl: string;
+    marketplaceIconUrl?: string;
+    desktop: ProfileAppPluginDesktop;
+    runtime: ProfileAppPluginRuntime;
+    package?: ProfileAppPackageDescriptor;
+}
+export type ProfileAppDescriptorRecord = object;
+export type ProfileAppVersionStatus = "installed" | "materializing" | "active" | "failed" | "rolled-back";
+export type ProfileAppMaterializationStatus = "pending" | "ready" | "failed" | "rolled-back";
+export interface ProfileAppSource {
+    catalogVersion: string;
+    commitHash: string;
+    entryUrl: string;
+    packageName?: string;
+    packageVersion?: string;
+    packageTarball?: string;
+    packageIntegrity?: string;
+    bundleUrl?: string;
+    bundleSha256?: string;
+    assetBaseUrl?: string;
+}
+export interface ProfileAppVersion<TDescriptor extends ProfileAppDescriptorRecord = ProfileAppPluginDescriptor> {
+    versionId: string;
+    version: string;
+    catalogVersion: string;
+    commitHash: string;
+    runtimeKind: string;
+    status: ProfileAppVersionStatus;
+    installedAt: string;
+    activatedAt?: string;
+    failedAt?: string;
+    failureReason?: string;
+    source: ProfileAppSource;
+    descriptor: TDescriptor;
+}
+export interface ProfileAppFile<TDescriptor extends ProfileAppDescriptorRecord = ProfileAppPluginDescriptor> {
+    schemaVersion: typeof PROFILE_APP_SCHEMA_VERSION;
+    userId: string;
+    profileId: string;
+    pluginSlug: string;
+    runtimeKind: string;
+    activeVersion: string | null;
+    installedVersions: Record<string, ProfileAppVersion<TDescriptor>>;
+    source: ProfileAppSource;
+    materialization: {
+        status: ProfileAppMaterializationStatus;
+        versionId: string | null;
+        updatedAt: string;
+        error?: string;
+    };
+    rollback?: {
+        previousActiveVersion: string;
+        failedVersion: string;
+        reason: string;
+        updatedAt: string;
+    };
+    configFiles: ProfileAppPluginConfigFile[];
+    dataRoots: {
+        appRoot: string;
+        dataRoot: string;
+        cacheRoot: string;
+        workspaceRoot: string;
+    };
+    desktop?: {
+        appId: string;
+        title: string;
+        description: string | null;
+        iconUrl: string;
+        entryUrl: string;
+        defaultWidth: number;
+        defaultHeight: number;
+        minWidth: number | null;
+        minHeight: number | null;
+        sortOrder: number;
+        positionX: number | null;
+        positionY: number | null;
+        installedAt: string;
+        updatedAt: string;
+    };
+    updatedAt: string;
+}
+export interface InstalledPluginApp<TPlugin extends ProfileAppPluginDescriptor = ProfileAppPluginDescriptor> {
+    id: string;
+    userId: string;
+    pluginSlug: string;
+    version: string;
+    commitHash: string;
+    title: string;
+    description: string | null;
+    iconUrl: string;
+    entryUrl: string;
+    defaultWidth: number;
+    defaultHeight: number;
+    minWidth: number | null;
+    minHeight: number | null;
+    sortOrder: number;
+    positionX: number | null;
+    positionY: number | null;
+    installedAt: string;
+    updatedAt: string;
+    descriptor?: TPlugin;
+    profileApp?: {
+        pluginSlug: string;
+        profileId: string;
+        pluginVersion: string;
+        activeVersion: string | null;
+        profileVfsRoot: string;
+        visibleConfigRoot: string;
+        configFiles: ProfileAppPluginConfigFile[];
+        dataRoots: ProfileAppFile<TPlugin>["dataRoots"];
+        materialization: ProfileAppFile<TPlugin>["materialization"];
+    };
+}
+/**
+ * Resolves the icon URL persisted into installed profile app files.
+ */
+export declare function profileAppInstallIconUrl(plugin: Pick<ProfileAppPluginDescriptor, "iconUrl" | "marketplaceIconUrl" | "runtime">): string;
+/**
+ * Implements profileVfsRoot behavior.
+ */
+export declare function profileVfsRoot(_profileId?: string | null): string;
+/**
+ * Implements profileAppsRoot behavior.
+ */
+export declare function profileAppsRoot(_profileId?: string | null): string;
+/**
+ * Implements profileR2Prefix behavior.
+ */
+export declare function profileR2Prefix(userId: string, profileId?: string | null): string;
+/**
+ * Implements profileAppFilePath behavior.
+ */
+export declare function profileAppFilePath(pluginSlug: string, profileId?: string | null): string;
+/**
+ * Implements profileAppVersionId behavior.
+ */
+export declare function profileAppVersionId(plugin: Pick<ProfileAppPluginDescriptor, "version" | "commitHash">): string;
+/**
+ * Implements createProfileAppFileFromPlugin behavior.
+ */
+export declare function createProfileAppFileFromPlugin<TPlugin extends ProfileAppPluginDescriptor>(input: {
+    userId: string;
+    plugin: TPlugin;
+    profileId?: string | null;
+    previous?: ProfileAppFile<TPlugin> | null;
+    installedApp?: InstalledPluginApp<TPlugin>;
+    now?: string;
+    activate?: boolean;
+}): ProfileAppFile<TPlugin>;
+/**
+ * Implements markProfileAppVersionFailed behavior.
+ */
+export declare function markProfileAppVersionFailed<TDescriptor extends ProfileAppDescriptorRecord>(file: ProfileAppFile<TDescriptor>, versionId: string, reason: string, now?: string): ProfileAppFile<TDescriptor>;
+/**
+ * Implements parseProfileAppFile behavior.
+ */
+export declare function parseProfileAppFile<TDescriptor extends ProfileAppDescriptorRecord = ProfileAppPluginDescriptor>(value: string, expected?: {
+    userId?: string;
+    profileId?: string | null;
+    pluginSlug?: string;
+}): ProfileAppFile<TDescriptor> | null;
+/**
+ * Implements installedPluginAppFromProfileAppFile behavior.
+ */
+export declare function installedPluginAppFromProfileAppFile<TPlugin extends ProfileAppPluginDescriptor>(file: ProfileAppFile<TPlugin>, sortOrder?: number): InstalledPluginApp<TPlugin> | null;
+//# sourceMappingURL=profile-app-file.d.ts.map

package/dist/profile-app-file.d.ts.map

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

package/dist/profile-app-file.js

@@ -0,0 +1,352 @@
+/**
+ * Defines SDK-owned profile-scoped marketplace app install file helpers.
+ * @owner w3kits-sdk
+ * @module sdk
+ * @boundary profile-app-file
+ */
+import { appFilePath, VISIBLE_HOME_ROOT, } from "./path-mapping.js";
+export const DEFAULT_PLUGIN_PROFILE_ID = "default";
+export const PROFILE_APP_SCHEMA_VERSION = 1;
+export const PROFILE_VISIBLE_ROOT = VISIBLE_HOME_ROOT;
+/**
+ * Implements isRecord behavior.
+ */
+function isRecord(value) {
+    return Boolean(value && typeof value === "object" && !Array.isArray(value));
+}
+/**
+ * Resolves the icon URL persisted into installed profile app files.
+ */
+export function profileAppInstallIconUrl(plugin) {
+    if (plugin.runtime.type === "local-only") {
+        return plugin.marketplaceIconUrl || plugin.iconUrl;
+    }
+    return plugin.iconUrl || plugin.marketplaceIconUrl || "";
+}
+/**
+ * Normalizes profile ids for profile app file helpers.
+ */
+function normalizeProfileAppProfileId(profileId) {
+    const normalized = (profileId || DEFAULT_PLUGIN_PROFILE_ID).trim();
+    if (!/^[a-z0-9][a-z0-9._-]{0,62}$/.test(normalized)) {
+        throw new Error("invalid_profile_id");
+    }
+    if (normalized === "." || normalized === "..") {
+        throw new Error("invalid_profile_id");
+    }
+    return normalized;
+}
+/**
+ * Implements normalizePluginSlug behavior.
+ */
+function normalizePluginSlug(pluginSlug) {
+    const normalized = pluginSlug.trim();
+    if (!/^[a-z0-9][a-z0-9._-]{0,127}$/.test(normalized)) {
+        throw new Error("invalid_plugin_slug");
+    }
+    return normalized;
+}
+/**
+ * Implements profileVfsRoot behavior.
+ */
+export function profileVfsRoot(_profileId) {
+    return PROFILE_VISIBLE_ROOT;
+}
+/**
+ * Implements profileAppsRoot behavior.
+ */
+export function profileAppsRoot(_profileId) {
+    return `${PROFILE_VISIBLE_ROOT}/apps`;
+}
+/**
+ * Implements profileR2Prefix behavior.
+ */
+export function profileR2Prefix(userId, profileId) {
+    return `users/${encodeURIComponent(userId)}/profiles/${normalizeProfileAppProfileId(profileId)}/`;
+}
+/**
+ * Implements profileAppFilePath behavior.
+ */
+export function profileAppFilePath(pluginSlug, profileId) {
+    void profileId;
+    return appFilePath(normalizePluginSlug(pluginSlug));
+}
+/**
+ * Implements profileAppVersionId behavior.
+ */
+export function profileAppVersionId(plugin) {
+    return `${plugin.version}+${plugin.commitHash.slice(0, 12)}`;
+}
+/**
+ * Implements profileAppSourceFromPlugin behavior.
+ */
+function profileAppSourceFromPlugin(plugin) {
+    return {
+        catalogVersion: plugin.version,
+        commitHash: plugin.commitHash,
+        entryUrl: plugin.entryUrl,
+        packageName: plugin.package?.name,
+        packageVersion: plugin.package?.version,
+        packageTarball: plugin.package?.tarball,
+        packageIntegrity: plugin.package?.integrity,
+        bundleUrl: plugin.runtime.bundle_url,
+        bundleSha256: plugin.runtime.sha256,
+        assetBaseUrl: plugin.runtime.assetBaseUrl,
+    };
+}
+/**
+ * Implements profileAppDataRoots behavior.
+ */
+function profileAppDataRoots(input) {
+    const root = `${profileVfsRoot(input.profileId)}/apps/${input.pluginSlug}`;
+    return {
+        appRoot: root,
+        dataRoot: `${root}/data`,
+        cacheRoot: `${root}/cache`,
+        workspaceRoot: `${profileVfsRoot(input.profileId)}/workspace`,
+    };
+}
+/**
+ * Implements profileDesktopFromInstalledApp behavior.
+ */
+function profileDesktopFromInstalledApp(app) {
+    return {
+        appId: app.id,
+        title: app.title,
+        description: app.description,
+        iconUrl: app.iconUrl,
+        entryUrl: app.entryUrl,
+        defaultWidth: app.defaultWidth,
+        defaultHeight: app.defaultHeight,
+        minWidth: app.minWidth,
+        minHeight: app.minHeight,
+        sortOrder: app.sortOrder,
+        positionX: app.positionX,
+        positionY: app.positionY,
+        installedAt: app.installedAt,
+        updatedAt: app.updatedAt,
+    };
+}
+/**
+ * Implements defaultProfileDesktopProjection behavior.
+ */
+function defaultProfileDesktopProjection(input) {
+    const previous = input.previous?.desktop;
+    return {
+        appId: previous?.appId ?? `profile:${input.profileId}:${input.pluginSlug}`,
+        title: input.plugin.name,
+        description: input.plugin.description ?? null,
+        iconUrl: profileAppInstallIconUrl(input.plugin),
+        entryUrl: input.plugin.entryUrl,
+        defaultWidth: input.plugin.desktop.defaultWidth,
+        defaultHeight: input.plugin.desktop.defaultHeight,
+        minWidth: input.plugin.desktop.minWidth ?? null,
+        minHeight: input.plugin.desktop.minHeight ?? null,
+        sortOrder: previous?.sortOrder ?? 0,
+        positionX: previous?.positionX ?? null,
+        positionY: previous?.positionY ?? null,
+        installedAt: previous?.installedAt ?? input.now,
+        updatedAt: input.now,
+    };
+}
+/**
+ * Implements createProfileAppFileFromPlugin behavior.
+ */
+export function createProfileAppFileFromPlugin(input) {
+    const profileId = normalizeProfileAppProfileId(input.profileId);
+    const pluginSlug = normalizePluginSlug(input.plugin.slug);
+    const now = input.now ?? new Date().toISOString();
+    const previous = input.previous?.userId === input.userId &&
+        input.previous.profileId === profileId &&
+        input.previous.pluginSlug === pluginSlug
+        ? input.previous
+        : null;
+    const versionId = profileAppVersionId(input.plugin);
+    const source = profileAppSourceFromPlugin(input.plugin);
+    const activate = input.activate ?? true;
+    const desktop = input.installedApp
+        ? profileDesktopFromInstalledApp(input.installedApp)
+        : defaultProfileDesktopProjection({
+            userId: input.userId,
+            profileId,
+            pluginSlug,
+            plugin: input.plugin,
+            previous,
+            now,
+        });
+    const installedVersions = {
+        ...(previous?.installedVersions ?? {}),
+    };
+    for (const [id, version] of Object.entries(installedVersions)) {
+        if (activate && id !== versionId && version.status === "active") {
+            installedVersions[id] = { ...version, status: "installed" };
+        }
+    }
+    installedVersions[versionId] = {
+        versionId,
+        version: input.plugin.version,
+        catalogVersion: input.plugin.version,
+        commitHash: input.plugin.commitHash,
+        runtimeKind: input.plugin.runtime.type,
+        status: activate ? "active" : "installed",
+        installedAt: installedVersions[versionId]?.installedAt ?? now,
+        activatedAt: activate ? now : installedVersions[versionId]?.activatedAt,
+        source,
+        descriptor: input.plugin,
+    };
+    const activeVersion = activate
+        ? versionId
+        : (previous?.activeVersion ?? null);
+    return {
+        schemaVersion: PROFILE_APP_SCHEMA_VERSION,
+        userId: input.userId,
+        profileId,
+        pluginSlug,
+        runtimeKind: input.plugin.runtime.type,
+        activeVersion,
+        installedVersions,
+        source,
+        materialization: {
+            status: activate ? "ready" : "pending",
+            versionId: activate ? versionId : null,
+            updatedAt: now,
+        },
+        configFiles: input.plugin.runtime.configFiles ?? [],
+        dataRoots: profileAppDataRoots({ profileId, pluginSlug }),
+        desktop,
+        updatedAt: now,
+    };
+}
+/**
+ * Implements markProfileAppVersionFailed behavior.
+ */
+export function markProfileAppVersionFailed(file, versionId, reason, now = new Date().toISOString()) {
+    const version = file.installedVersions[versionId];
+    if (!version)
+        throw new Error("unknown_profile_app_version");
+    const previousActiveVersion = file.activeVersion && file.activeVersion !== versionId
+        ? file.activeVersion
+        : Object.values(file.installedVersions).find((candidate) => candidate.versionId !== versionId && candidate.status === "active")?.versionId;
+    return {
+        ...file,
+        activeVersion: previousActiveVersion ?? null,
+        installedVersions: {
+            ...file.installedVersions,
+            [versionId]: {
+                ...version,
+                status: "failed",
+                failedAt: now,
+                failureReason: reason,
+            },
+        },
+        materialization: {
+            status: "failed",
+            versionId,
+            updatedAt: now,
+            error: reason,
+        },
+        rollback: previousActiveVersion
+            ? {
+                previousActiveVersion,
+                failedVersion: versionId,
+                reason,
+                updatedAt: now,
+            }
+            : undefined,
+        updatedAt: now,
+    };
+}
+/**
+ * Implements parseProfileAppFile behavior.
+ */
+export function parseProfileAppFile(value, expected) {
+    let parsed;
+    try {
+        parsed = JSON.parse(value);
+    }
+    catch {
+        return null;
+    }
+    if (!isRecord(parsed))
+        return null;
+    if (parsed.schemaVersion !== PROFILE_APP_SCHEMA_VERSION)
+        return null;
+    if (typeof parsed.userId !== "string")
+        return null;
+    if (typeof parsed.profileId !== "string")
+        return null;
+    if (typeof parsed.pluginSlug !== "string")
+        return null;
+    if (typeof parsed.runtimeKind !== "string")
+        return null;
+    if (parsed.activeVersion !== null &&
+        typeof parsed.activeVersion !== "string") {
+        return null;
+    }
+    if (!isRecord(parsed.installedVersions))
+        return null;
+    if (!isRecord(parsed.source))
+        return null;
+    if (!isRecord(parsed.materialization))
+        return null;
+    if (!isRecord(parsed.dataRoots))
+        return null;
+    if (!Array.isArray(parsed.configFiles))
+        return null;
+    if (typeof parsed.updatedAt !== "string")
+        return null;
+    const profileId = normalizeProfileAppProfileId(expected?.profileId ?? parsed.profileId);
+    const pluginSlug = normalizePluginSlug(expected?.pluginSlug ?? parsed.pluginSlug);
+    if (expected?.userId && parsed.userId !== expected.userId)
+        return null;
+    if (parsed.profileId !== profileId)
+        return null;
+    if (parsed.pluginSlug !== pluginSlug)
+        return null;
+    return parsed;
+}
+/**
+ * Implements installedPluginAppFromProfileAppFile behavior.
+ */
+export function installedPluginAppFromProfileAppFile(file, sortOrder = 0) {
+    const activeVersion = file.activeVersion
+        ? file.installedVersions[file.activeVersion]
+        : undefined;
+    if (!activeVersion)
+        return null;
+    const plugin = activeVersion.descriptor;
+    const desktop = file.desktop;
+    return {
+        id: desktop?.appId ?? `profile:${file.profileId}:${file.pluginSlug}`,
+        userId: file.userId,
+        pluginSlug: file.pluginSlug,
+        version: activeVersion.version,
+        commitHash: activeVersion.commitHash,
+        title: desktop?.title ?? plugin.name,
+        description: desktop?.description ?? plugin.description ?? null,
+        iconUrl: desktop?.iconUrl ?? profileAppInstallIconUrl(plugin),
+        entryUrl: desktop?.entryUrl ?? plugin.entryUrl,
+        defaultWidth: desktop?.defaultWidth ?? plugin.desktop.defaultWidth,
+        defaultHeight: desktop?.defaultHeight ?? plugin.desktop.defaultHeight,
+        minWidth: desktop?.minWidth ?? plugin.desktop.minWidth ?? null,
+        minHeight: desktop?.minHeight ?? plugin.desktop.minHeight ?? null,
+        sortOrder: desktop?.sortOrder ?? sortOrder,
+        positionX: desktop?.positionX ?? null,
+        positionY: desktop?.positionY ?? null,
+        installedAt: desktop?.installedAt ?? activeVersion.installedAt,
+        updatedAt: desktop?.updatedAt ?? file.updatedAt,
+        descriptor: plugin,
+        profileApp: {
+            pluginSlug: file.pluginSlug,
+            profileId: file.profileId,
+            pluginVersion: activeVersion.version,
+            activeVersion: file.activeVersion,
+            profileVfsRoot: profileVfsRoot(file.profileId),
+            visibleConfigRoot: `${profileVfsRoot(file.profileId)}/.config/${file.pluginSlug}`,
+            configFiles: file.configFiles,
+            dataRoots: file.dataRoots,
+            materialization: file.materialization,
+        },
+    };
+}
+//# sourceMappingURL=profile-app-file.js.map

package/dist/profile-app-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-app-file.js","sourceRoot":"","sources":["../src/profile-app-file.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,WAAW,EAEX,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,CAAC,MAAM,yBAAyB,GAAG,SAAS,CAAC;AACnD,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC;AAC5C,MAAM,CAAC,MAAM,oBAAoB,GAAG,iBAAiB,CAAC;AA+KtD;;GAEG;AACH,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACtC,MAAsF;IAEtF,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QACzC,OAAO,MAAM,CAAC,kBAAkB,IAAI,MAAM,CAAC,OAAO,CAAC;IACrD,CAAC;IACD,OAAO,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,kBAAkB,IAAI,EAAE,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,SAAS,4BAA4B,CAAC,SAAyB;IAC7D,MAAM,UAAU,GAAG,CAAC,SAAS,IAAI,yBAAyB,CAAC,CAAC,IAAI,EAAE,CAAC;IACnE,IAAI,CAAC,6BAA6B,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;IACxC,CAAC;IACD,IAAI,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,UAAkB;IAC7C,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;IACrC,IAAI,CAAC,8BAA8B,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,UAA0B;IACvD,OAAO,oBAAoB,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,UAA0B;IACxD,OAAO,GAAG,oBAAoB,OAAO,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,SAAyB;IACvE,OAAO,SAAS,kBAAkB,CAAC,MAAM,CAAC,aAAa,4BAA4B,CAAC,SAAS,CAAC,GAAG,CAAC;AACpG,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,UAAkB,EAClB,SAAyB;IAEzB,KAAK,SAAS,CAAC;IACf,OAAO,WAAW,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC,CAAC;AACtD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAkE;IAElE,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;AAC/D,CAAC;AAED;;GAEG;AACH,SAAS,0BAA0B,CAAC,MAAkC;IACpE,OAAO;QACL,cAAc,EAAE,MAAM,CAAC,OAAO;QAC9B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,WAAW,EAAE,MAAM,CAAC,OAAO,EAAE,IAAI;QACjC,cAAc,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO;QACvC,cAAc,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO;QACvC,gBAAgB,EAAE,MAAM,CAAC,OAAO,EAAE,SAAS;QAC3C,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,UAAU;QACpC,YAAY,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM;QACnC,YAAY,EAAE,MAAM,CAAC,OAAO,CAAC,YAAY;KACf,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,KAAgD;IAC3E,MAAM,IAAI,GAAG,GAAG,cAAc,CAAC,KAAK,CAAC,SAAS,CAAC,SAAS,KAAK,CAAC,UAAU,EAAE,CAAC;IAC3E,OAAO;QACL,OAAO,EAAE,IAAI;QACb,QAAQ,EAAE,GAAG,IAAI,OAAO;QACxB,SAAS,EAAE,GAAG,IAAI,QAAQ;QAC1B,aAAa,EAAE,GAAG,cAAc,CAAC,KAAK,CAAC,SAAS,CAAC,YAAY;KAC9D,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,8BAA8B,CAAC,GAAuB;IAC7D,OAAO;QACL,KAAK,EAAE,GAAG,CAAC,EAAE;QACb,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,YAAY,EAAE,GAAG,CAAC,YAAY;QAC9B,aAAa,EAAE,GAAG,CAAC,aAAa;QAChC,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,SAAS,EAAE,GAAG,CAAC,SAAS;KACzB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,+BAA+B,CAEtC,KAOD;IACC,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC;IACzC,OAAO;QACL,KAAK,EAAE,QAAQ,EAAE,KAAK,IAAI,WAAW,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,UAAU,EAAE;QAC1E,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI;QACxB,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,WAAW,IAAI,IAAI;QAC7C,OAAO,EAAE,wBAAwB,CAAC,KAAK,CAAC,MAAM,CAAC;QAC/C,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,QAAQ;QAC/B,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY;QAC/C,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,aAAa;QACjD,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,IAAI,IAAI;QAC/C,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,IAAI,IAAI;QACjD,SAAS,EAAE,QAAQ,EAAE,SAAS,IAAI,CAAC;QACnC,SAAS,EAAE,QAAQ,EAAE,SAAS,IAAI,IAAI;QACtC,SAAS,EAAE,QAAQ,EAAE,SAAS,IAAI,IAAI;QACtC,WAAW,EAAE,QAAQ,EAAE,WAAW,IAAI,KAAK,CAAC,GAAG;QAC/C,SAAS,EAAE,KAAK,CAAC,GAAG;KACrB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,8BAA8B,CAE5C,KAQD;IACC,MAAM,SAAS,GAAG,4BAA4B,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAChE,MAAM,UAAU,GAAG,mBAAmB,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1D,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAClD,MAAM,QAAQ,GACZ,KAAK,CAAC,QAAQ,EAAE,MAAM,KAAK,KAAK,CAAC,MAAM;QACvC,KAAK,CAAC,QAAQ,CAAC,SAAS,KAAK,SAAS;QACtC,KAAK,CAAC,QAAQ,CAAC,UAAU,KAAK,UAAU;QACtC,CAAC,CAAC,KAAK,CAAC,QAAQ;QAChB,CAAC,CAAC,IAAI,CAAC;IACX,MAAM,SAAS,GAAG,mBAAmB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,0BAA0B,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC;IACxC,MAAM,OAAO,GAAG,KAAK,CAAC,YAAY;QAChC,CAAC,CAAC,8BAA8B,CAAC,KAAK,CAAC,YAAY,CAAC;QACpD,CAAC,CAAC,+BAA+B,CAAC;YAC9B,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,SAAS;YACT,UAAU;YACV,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,QAAQ;YACR,GAAG;SACJ,CAAC,CAAC;IACP,MAAM,iBAAiB,GAA+C;QACpE,GAAG,CAAC,QAAQ,EAAE,iBAAiB,IAAI,EAAE,CAAC;KACvC,CAAC;IAEF,KAAK,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAC9D,IAAI,QAAQ,IAAI,EAAE,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YAChE,iBAAiB,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;QAC9D,CAAC;IACH,CAAC;IAED,iBAAiB,CAAC,SAAS,CAAC,GAAG;QAC7B,SAAS;QACT,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO;QAC7B,cAAc,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO;QACpC,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,UAAU;QACnC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI;QACtC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW;QACzC,WAAW,EAAE,iBAAiB,CAAC,SAAS,CAAC,EAAE,WAAW,IAAI,GAAG;QAC7D,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,iBAAiB,CAAC,SAAS,CAAC,EAAE,WAAW;QACvE,MAAM;QACN,UAAU,EAAE,KAAK,CAAC,MAAM;KACzB,CAAC;IAEF,MAAM,aAAa,GAAG,QAAQ;QAC5B,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,CAAC,QAAQ,EAAE,aAAa,IAAI,IAAI,CAAC,CAAC;IACtC,OAAO;QACL,aAAa,EAAE,0BAA0B;QACzC,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,SAAS;QACT,UAAU;QACV,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI;QACtC,aAAa;QACb,iBAAiB;QACjB,MAAM;QACN,eAAe,EAAE;YACf,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;YACtC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI;YACtC,SAAS,EAAE,GAAG;SACf;QACD,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,IAAI,EAAE;QACnD,SAAS,EAAE,mBAAmB,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;QACzD,OAAO;QACP,SAAS,EAAE,GAAG;KACf,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,2BAA2B,CAGzC,IAAiC,EACjC,SAAiB,EACjB,MAAc,EACd,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;IAE9B,MAAM,OAAO,GAAG,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAClD,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IAC7D,MAAM,qBAAqB,GACzB,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS;QACpD,CAAC,CAAC,IAAI,CAAC,aAAa;QACpB,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,IAAI,CACxC,CAAC,SAAS,EAAE,EAAE,CACZ,SAAS,CAAC,SAAS,KAAK,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,QAAQ,CACrE,EAAE,SAAS,CAAC;IACnB,OAAO;QACL,GAAG,IAAI;QACP,aAAa,EAAE,qBAAqB,IAAI,IAAI;QAC5C,iBAAiB,EAAE;YACjB,GAAG,IAAI,CAAC,iBAAiB;YACzB,CAAC,SAAS,CAAC,EAAE;gBACX,GAAG,OAAO;gBACV,MAAM,EAAE,QAAQ;gBAChB,QAAQ,EAAE,GAAG;gBACb,aAAa,EAAE,MAAM;aACtB;SACF;QACD,eAAe,EAAE;YACf,MAAM,EAAE,QAAQ;YAChB,SAAS;YACT,SAAS,EAAE,GAAG;YACd,KAAK,EAAE,MAAM;SACd;QACD,QAAQ,EAAE,qBAAqB;YAC7B,CAAC,CAAC;gBACE,qBAAqB;gBACrB,aAAa,EAAE,SAAS;gBACxB,MAAM;gBACN,SAAS,EAAE,GAAG;aACf;YACH,CAAC,CAAC,SAAS;QACb,SAAS,EAAE,GAAG;KACf,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAGjC,KAAa,EACb,QAIC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,MAAM,CAAC,aAAa,KAAK,0BAA0B;QAAE,OAAO,IAAI,CAAC;IACrE,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACnD,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACtD,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACvD,IAAI,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACxD,IACE,MAAM,CAAC,aAAa,KAAK,IAAI;QAC7B,OAAO,MAAM,CAAC,aAAa,KAAK,QAAQ,EACxC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,iBAAiB,CAAC;QAAE,OAAO,IAAI,CAAC;IACrD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1C,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,eAAe,CAAC;QAAE,OAAO,IAAI,CAAC;IACnD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC;QAAE,OAAO,IAAI,CAAC;IACpD,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAEtD,MAAM,SAAS,GAAG,4BAA4B,CAC5C,QAAQ,EAAE,SAAS,IAAI,MAAM,CAAC,SAAS,CACxC,CAAC;IACF,MAAM,UAAU,GAAG,mBAAmB,CACpC,QAAQ,EAAE,UAAU,IAAI,MAAM,CAAC,UAAU,CAC1C,CAAC;IACF,IAAI,QAAQ,EAAE,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACvE,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAChD,IAAI,MAAM,CAAC,UAAU,KAAK,UAAU;QAAE,OAAO,IAAI,CAAC;IAClD,OAAO,MAAgD,CAAC;AAC1D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oCAAoC,CAGlD,IAA6B,EAC7B,SAAS,GAAG,CAAC;IAEb,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa;QACtC,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,aAAa,CAAC;QAC5C,CAAC,CAAC,SAAS,CAAC;IACd,IAAI,CAAC,aAAa;QAAE,OAAO,IAAI,CAAC;IAChC,MAAM,MAAM,GAAG,aAAa,CAAC,UAAU,CAAC;IACxC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAC7B,OAAO;QACL,EAAE,EAAE,OAAO,EAAE,KAAK,IAAI,WAAW,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE;QACpE,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,OAAO,EAAE,aAAa,CAAC,OAAO;QAC9B,UAAU,EAAE,aAAa,CAAC,UAAU;QACpC,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,MAAM,CAAC,IAAI;QACpC,WAAW,EAAE,OAAO,EAAE,WAAW,IAAI,MAAM,CAAC,WAAW,IAAI,IAAI;QAC/D,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,wBAAwB,CAAC,MAAM,CAAC;QAC7D,QAAQ,EAAE,OAAO,EAAE,QAAQ,IAAI,MAAM,CAAC,QAAQ;QAC9C,YAAY,EAAE,OAAO,EAAE,YAAY,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY;QAClE,aAAa,EAAE,OAAO,EAAE,aAAa,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa;QACrE,QAAQ,EAAE,OAAO,EAAE,QAAQ,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,IAAI,IAAI;QAC9D,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,IAAI,IAAI;QACjE,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,SAAS;QAC1C,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,IAAI;QACrC,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,IAAI;QACrC,WAAW,EAAE,OAAO,EAAE,WAAW,IAAI,aAAa,CAAC,WAAW;QAC9D,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,IAAI,CAAC,SAAS;QAC/C,UAAU,EAAE,MAAM;QAClB,UAAU,EAAE;YACV,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,aAAa,EAAE,aAAa,CAAC,OAAO;YACpC,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,cAAc,EAAE,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC;YAC9C,iBAAiB,EAAE,GAAG,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,IAAI,CAAC,UAAU,EAAE;YACjF,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,eAAe,EAAE,IAAI,CAAC,eAAe;SACtC;KACF,CAAC;AACJ,CAAC"}

package/dist/r2-client.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Defines R2 native data-plane capability descriptors for SDK clients.
+ * @owner w3kits-sdk
+ * @module sdk
+ * @boundary r2-client
+ */
+import type { StorageCapabilityAction } from "./storage/index.js";
+import type { StorageCapability } from "./storage/index.js";
+export type R2TemporaryCredentials = {
+    accessKeyId: string;
+    secretAccessKey: string;
+    sessionToken?: string;
+    expiresAt: string;
+};
+export type R2PresignedRequest = {
+    key: string;
+    method: "GET" | "PUT" | "DELETE";
+    url: string;
+    headers?: Record<string, string>;
+    expiresAt: string;
+};
+export type R2DataPlaneDescriptor = {
+    bucket: string;
+    accountId?: string;
+    endpoint: string;
+    region: "auto";
+    forcePathStyle: true;
+    prefix: string;
+    actions: StorageCapabilityAction[];
+    credentials?: R2TemporaryCredentials;
+    presigned?: R2PresignedRequest[];
+};
+export declare const W3KITS_STORAGE_CAPABILITY_DESCRIPTOR_VERSION = "w3kits.storage.capability.v1";
+export type W3KitsStorageCapabilityDescriptor = {
+    version: typeof W3KITS_STORAGE_CAPABILITY_DESCRIPTOR_VERSION;
+    visibleRoot: StorageCapability["root"];
+    capability: StorageCapability;
+    r2: R2DataPlaneDescriptor;
+    auth: {
+        mode: "runtime-session";
+        header: "x-w3kits-runtime-session";
+    };
+    localFirst: {
+        enabled: boolean;
+        store: "indexeddb-opfs";
+        commit: {
+            interactiveSuccess: "local";
+            remoteSync: "background";
+        };
+        flushPolicy: {
+            onChange: boolean;
+            debounceMs: number;
+            lifecycleEvents: string[];
+            highFrequencyPolling: false;
+        };
+    };
+    sync: {
+        commitSemantics: "local-durable-first";
+        largeBodyThresholdBytes: number;
+    };
+};
+export type W3KitsStorageCapabilityDescriptorInput = {
+    capability: StorageCapability;
+    r2: R2DataPlaneDescriptor;
+    localFirstEnabled?: boolean;
+    largeBodyThresholdBytes?: number;
+};
+/**
+ * Creates the SDK-owned descriptor shape consumed by plugin/runtime bridges.
+ */
+export declare function createW3KitsStorageCapabilityDescriptor(input: W3KitsStorageCapabilityDescriptorInput): W3KitsStorageCapabilityDescriptor;
+/**
+ * Builds a path-style R2 object URL from a scoped descriptor.
+ */
+export declare function r2ObjectUrl(descriptor: Pick<R2DataPlaneDescriptor, "endpoint" | "bucket" | "prefix">, key: string): string;
+//# sourceMappingURL=r2-client.d.ts.map

package/dist/r2-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"r2-client.d.ts","sourceRoot":"","sources":["../src/r2-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,MAAM,MAAM,sBAAsB,GAAG;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,KAAK,GAAG,KAAK,GAAG,QAAQ,CAAC;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,uBAAuB,EAAE,CAAC;IACnC,WAAW,CAAC,EAAE,sBAAsB,CAAC;IACrC,SAAS,CAAC,EAAE,kBAAkB,EAAE,CAAC;CAClC,CAAC;AAEF,eAAO,MAAM,4CAA4C,iCACzB,CAAC;AAEjC,MAAM,MAAM,iCAAiC,GAAG;IAC9C,OAAO,EAAE,OAAO,4CAA4C,CAAC;IAC7D,WAAW,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACvC,UAAU,EAAE,iBAAiB,CAAC;IAC9B,EAAE,EAAE,qBAAqB,CAAC;IAC1B,IAAI,EAAE;QACJ,IAAI,EAAE,iBAAiB,CAAC;QACxB,MAAM,EAAE,0BAA0B,CAAC;KACpC,CAAC;IACF,UAAU,EAAE;QACV,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,EAAE,gBAAgB,CAAC;QACxB,MAAM,EAAE;YACN,kBAAkB,EAAE,OAAO,CAAC;YAC5B,UAAU,EAAE,YAAY,CAAC;SAC1B,CAAC;QACF,WAAW,EAAE;YACX,QAAQ,EAAE,OAAO,CAAC;YAClB,UAAU,EAAE,MAAM,CAAC;YACnB,eAAe,EAAE,MAAM,EAAE,CAAC;YAC1B,oBAAoB,EAAE,KAAK,CAAC;SAC7B,CAAC;KACH,CAAC;IACF,IAAI,EAAE;QACJ,eAAe,EAAE,qBAAqB,CAAC;QACvC,uBAAuB,EAAE,MAAM,CAAC;KACjC,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,sCAAsC,GAAG;IACnD,UAAU,EAAE,iBAAiB,CAAC;IAC9B,EAAE,EAAE,qBAAqB,CAAC;IAC1B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC,CAAC;AAEF;;GAEG;AACH,wBAAgB,uCAAuC,CACrD,KAAK,EAAE,sCAAsC,GAC5C,iCAAiC,CAmCnC;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE,IAAI,CAAC,qBAAqB,EAAE,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAC,EACzE,GAAG,EAAE,MAAM,GACV,MAAM,CAWR"}