@w3kits/sdk 0.1.0

package/README.md

@@ -0,0 +1,29 @@
+# @w3kits/sdk
+
+Client-first W3Kits SDK for browser, plugin, container, storage, visible path,
+local cache, R2 capability, and `.app` file semantics.
+
+## Entry Points
+
+- `@w3kits/sdk`
+- `@w3kits/sdk/browser`
+- `@w3kits/sdk/plugin`
+- `@w3kits/sdk/container`
+- `@w3kits/sdk/storage`
+- `@w3kits/sdk/path-mapping`
+- `@w3kits/sdk/local-cache`
+- `@w3kits/sdk/r2-client`
+- `@w3kits/sdk/app-file`
+- `@w3kits/sdk/profile-app-file`
+
+The `profile-app-file` entry point owns the shared profile `.app` descriptor
+helpers used by Core, Web installed-app projection, and the independent
+marketplace frontend.
+
+## Release Check
+
+```sh
+pnpm --filter @w3kits/sdk typecheck
+pnpm --filter @w3kits/sdk test
+pnpm --filter @w3kits/sdk pack:check
+```

package/dist/app-file.d.ts

@@ -0,0 +1,39 @@
+export declare const W3KITS_APP_FILE_SCHEMA_VERSION = 1;
+export declare const W3KITS_APP_FILE_CONTENT_TYPE = "application/vnd.w3kits.app+json";
+export type W3KitsAppFile = {
+    schemaVersion: typeof W3KITS_APP_FILE_SCHEMA_VERSION;
+    kind: "w3kits.app";
+    userId: string;
+    profileId: string;
+    pluginSlug: string;
+    title: string;
+    entryUrl: string;
+    iconUrl?: string;
+    runtime?: Record<string, unknown>;
+    configRoot: string;
+    installedAt: string;
+    updatedAt: string;
+};
+export type CreateAppFileInput = {
+    userId: string;
+    profileId?: string | null;
+    pluginSlug: string;
+    title: string;
+    entryUrl: string;
+    iconUrl?: string;
+    runtime?: Record<string, unknown>;
+    now?: string;
+};
+/**
+ * Builds the visible .app path for a plugin.
+ */
+export declare function w3kitsAppFilePath(pluginSlug: string): string;
+/**
+ * Creates a W3Kits .app file descriptor.
+ */
+export declare function createW3KitsAppFile(input: CreateAppFileInput): W3KitsAppFile;
+/**
+ * Parses a W3Kits .app file, returning null for malformed or mismatched files.
+ */
+export declare function parseW3KitsAppFile(source: string, expected?: Partial<Pick<W3KitsAppFile, "userId" | "profileId" | "pluginSlug">>): W3KitsAppFile | null;
+//# sourceMappingURL=app-file.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"app-file.d.ts","sourceRoot":"","sources":["../src/app-file.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,8BAA8B,IAAI,CAAC;AAChD,eAAO,MAAM,4BAA4B,oCAAoC,CAAC;AAE9E,MAAM,MAAM,aAAa,GAAG;IAC1B,aAAa,EAAE,OAAO,8BAA8B,CAAC;IACrD,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,kBAAkB,GAAG,aAAa,CAiB5E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,GAAG,WAAW,GAAG,YAAY,CAAC,CAAM,GACjF,aAAa,GAAG,IAAI,CA6BtB"}

package/dist/app-file.js

@@ -0,0 +1,81 @@
+/**
+ * Defines SDK .app file helpers for installed plugin launchers.
+ * @owner w3kits-sdk
+ * @module sdk
+ * @boundary app-file
+ */
+import { appFilePath, pluginConfigRoot, normalizePluginSlug, normalizeProfileId, normalizeUserId, } from "./path-mapping.js";
+export const W3KITS_APP_FILE_SCHEMA_VERSION = 1;
+export const W3KITS_APP_FILE_CONTENT_TYPE = "application/vnd.w3kits.app+json";
+/**
+ * Builds the visible .app path for a plugin.
+ */
+export function w3kitsAppFilePath(pluginSlug) {
+    return appFilePath(pluginSlug);
+}
+/**
+ * Creates a W3Kits .app file descriptor.
+ */
+export function createW3KitsAppFile(input) {
+    const now = input.now ?? new Date().toISOString();
+    const pluginSlug = normalizePluginSlug(input.pluginSlug);
+    return {
+        schemaVersion: W3KITS_APP_FILE_SCHEMA_VERSION,
+        kind: "w3kits.app",
+        userId: normalizeUserId(input.userId),
+        profileId: normalizeProfileId(input.profileId),
+        pluginSlug,
+        title: input.title,
+        entryUrl: input.entryUrl,
+        iconUrl: input.iconUrl,
+        runtime: input.runtime,
+        configRoot: pluginConfigRoot(pluginSlug),
+        installedAt: now,
+        updatedAt: now,
+    };
+}
+/**
+ * Parses a W3Kits .app file, returning null for malformed or mismatched files.
+ */
+export function parseW3KitsAppFile(source, expected = {}) {
+    let value;
+    try {
+        value = JSON.parse(source);
+    }
+    catch {
+        return null;
+    }
+    if (!isRecord(value))
+        return null;
+    if (value.schemaVersion !== W3KITS_APP_FILE_SCHEMA_VERSION)
+        return null;
+    if (value.kind !== "w3kits.app")
+        return null;
+    if (typeof value.userId !== "string" ||
+        typeof value.profileId !== "string" ||
+        typeof value.pluginSlug !== "string" ||
+        typeof value.title !== "string" ||
+        typeof value.entryUrl !== "string" ||
+        typeof value.configRoot !== "string" ||
+        typeof value.installedAt !== "string" ||
+        typeof value.updatedAt !== "string") {
+        return null;
+    }
+    const appFile = value;
+    if (expected.userId && appFile.userId !== expected.userId)
+        return null;
+    if (expected.profileId && appFile.profileId !== expected.profileId)
+        return null;
+    if (expected.pluginSlug && appFile.pluginSlug !== expected.pluginSlug)
+        return null;
+    if (appFile.configRoot !== pluginConfigRoot(appFile.pluginSlug))
+        return null;
+    return appFile;
+}
+/**
+ * Checks whether a value is a plain record.
+ */
+function isRecord(value) {
+    return Boolean(value && typeof value === "object" && !Array.isArray(value));
+}
+//# sourceMappingURL=app-file.js.map

package/dist/app-file.js.map

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

package/dist/browser.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Browser SDK entrypoint.
+ * @owner w3kits-sdk
+ * @module sdk
+ */
+export * from "./path-mapping.js";
+export * from "./local-cache.js";
+export * from "./app-file.js";
+export * from "./profile-app-file.js";
+export * from "./storage/index.js";
+export * from "./r2-client.js";
+//# sourceMappingURL=browser.d.ts.map

package/dist/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC"}

package/dist/browser.js

@@ -0,0 +1,12 @@
+/**
+ * Browser SDK entrypoint.
+ * @owner w3kits-sdk
+ * @module sdk
+ */
+export * from "./path-mapping.js";
+export * from "./local-cache.js";
+export * from "./app-file.js";
+export * from "./profile-app-file.js";
+export * from "./storage/index.js";
+export * from "./r2-client.js";
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC"}

package/dist/container.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Container SDK entrypoint.
+ * @owner w3kits-sdk
+ * @module sdk
+ */
+import { VISIBLE_HOME_ROOT } from "./path-mapping.js";
+import { type R2DataPlaneDescriptor, type W3KitsStorageCapabilityDescriptor } from "./r2-client.js";
+export * from "./path-mapping.js";
+export * from "./storage/index.js";
+export * from "./r2-client.js";
+export type W3KitsContainerStorage = {
+    descriptor: W3KitsStorageCapabilityDescriptor;
+    visibleRoot: typeof VISIBLE_HOME_ROOT;
+    capability: W3KitsStorageCapabilityDescriptor["capability"];
+    r2: R2DataPlaneDescriptor;
+    authHeader: "x-w3kits-runtime-session";
+    sessionFile: "/home/agent/.cache/w3kits-storage/session.json";
+    r2KeyForVisiblePath(visiblePath: string): string;
+};
+/**
+ * Represents container storage descriptor validation failures.
+ */
+export declare class W3KitsContainerStorageError extends Error {
+    readonly code: "legacy_storage_descriptor" | "invalid_storage_descriptor" | "invalid_storage_descriptor_version" | "legacy_fake_credentials" | "permanent_r2_credentials" | "descriptor_scope_mismatch" | "path_outside_capability";
+    /**
+     * Initializes a container storage error with a stable code.
+     */
+    constructor(code: "legacy_storage_descriptor" | "invalid_storage_descriptor" | "invalid_storage_descriptor_version" | "legacy_fake_credentials" | "permanent_r2_credentials" | "descriptor_scope_mismatch" | "path_outside_capability", message: string);
+}
+/**
+ * Validates and initializes runtime-scoped container storage descriptors.
+ */
+export declare function initializeW3KitsContainerStorage(input: {
+    descriptor: unknown;
+}): W3KitsContainerStorage;
+//# sourceMappingURL=container.d.ts.map

package/dist/container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../src/container.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAsB,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,iCAAiC,EACvC,MAAM,gBAAgB,CAAC;AAExB,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAI/B,MAAM,MAAM,sBAAsB,GAAG;IACnC,UAAU,EAAE,iCAAiC,CAAC;IAC9C,WAAW,EAAE,OAAO,iBAAiB,CAAC;IACtC,UAAU,EAAE,iCAAiC,CAAC,YAAY,CAAC,CAAC;IAC5D,EAAE,EAAE,qBAAqB,CAAC;IAC1B,UAAU,EAAE,0BAA0B,CAAC;IACvC,WAAW,EAAE,gDAAgD,CAAC;IAC9D,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;CAClD,CAAC;AAEF;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,KAAK;aAKlC,IAAI,EAChB,2BAA2B,GAC3B,4BAA4B,GAC5B,oCAAoC,GACpC,yBAAyB,GACzB,0BAA0B,GAC1B,2BAA2B,GAC3B,yBAAyB;IAX/B;;OAEG;gBAEe,IAAI,EAChB,2BAA2B,GAC3B,4BAA4B,GAC5B,oCAAoC,GACpC,yBAAyB,GACzB,0BAA0B,GAC1B,2BAA2B,GAC3B,yBAAyB,EAC7B,OAAO,EAAE,MAAM;CAKlB;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAAC,KAAK,EAAE;IACtD,UAAU,EAAE,OAAO,CAAC;CACrB,GAAG,sBAAsB,CA6CzB"}

package/dist/container.js

@@ -0,0 +1,125 @@
+/**
+ * Container SDK entrypoint.
+ * @owner w3kits-sdk
+ * @module sdk
+ */
+import { mapVisiblePathToR2, VISIBLE_HOME_ROOT } from "./path-mapping.js";
+import { W3KITS_STORAGE_CAPABILITY_DESCRIPTOR_VERSION, } from "./r2-client.js";
+export * from "./path-mapping.js";
+export * from "./storage/index.js";
+export * from "./r2-client.js";
+const LEGACY_OBJECT_FACADE_PATH = `/${["api", "vfs", "objects"].join("/")}`;
+/**
+ * Represents container storage descriptor validation failures.
+ */
+export class W3KitsContainerStorageError extends Error {
+    code;
+    /**
+     * Initializes a container storage error with a stable code.
+     */
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "W3KitsContainerStorageError";
+    }
+}
+/**
+ * Validates and initializes runtime-scoped container storage descriptors.
+ */
+export function initializeW3KitsContainerStorage(input) {
+    const descriptor = assertContainerStorageDescriptor(input.descriptor);
+    if (descriptor.visibleRoot !== VISIBLE_HOME_ROOT) {
+        throw new W3KitsContainerStorageError("descriptor_scope_mismatch", "Container storage descriptors must be scoped to /home/agent");
+    }
+    const expectedPrefix = mapVisiblePathToR2(descriptor.visibleRoot, {
+        userId: descriptor.capability.userId,
+        profileId: descriptor.capability.profileId,
+    }).r2Key;
+    if (descriptor.r2.prefix !== expectedPrefix) {
+        throw new W3KitsContainerStorageError("descriptor_scope_mismatch", "Container storage descriptor R2 prefix does not match /home/agent");
+    }
+    return {
+        descriptor,
+        visibleRoot: VISIBLE_HOME_ROOT,
+        capability: descriptor.capability,
+        r2: descriptor.r2,
+        authHeader: descriptor.auth.header,
+        sessionFile: "/home/agent/.cache/w3kits-storage/session.json",
+        r2KeyForVisiblePath(visiblePath) {
+            let mapping;
+            try {
+                mapping = mapVisiblePathToR2(visiblePath, descriptor.capability);
+            }
+            catch {
+                throw new W3KitsContainerStorageError("path_outside_capability", "Visible path is outside the container storage capability");
+            }
+            if (!r2KeyWithinPrefix(mapping.r2Key, descriptor.r2.prefix)) {
+                throw new W3KitsContainerStorageError("path_outside_capability", "Visible path is outside the container storage capability");
+            }
+            return mapping.r2Key;
+        },
+    };
+}
+/**
+ * Asserts the descriptor shape used by the container storage agent.
+ */
+function assertContainerStorageDescriptor(value) {
+    const descriptor = record(value, "invalid_storage_descriptor");
+    if (descriptor.type === "w3kits-vfs-object-facade" ||
+        descriptor.endpoint === LEGACY_OBJECT_FACADE_PATH) {
+        throw new W3KitsContainerStorageError("legacy_storage_descriptor", "Legacy VFS object-facade descriptors are not accepted by the SDK container bridge");
+    }
+    if (descriptor.version !== W3KITS_STORAGE_CAPABILITY_DESCRIPTOR_VERSION) {
+        throw new W3KitsContainerStorageError("invalid_storage_descriptor_version", "Unsupported W3Kits storage descriptor version");
+    }
+    const capability = record(descriptor.capability, "invalid_storage_descriptor");
+    const r2 = record(descriptor.r2, "invalid_storage_descriptor");
+    const auth = record(descriptor.auth, "invalid_storage_descriptor");
+    if (typeof descriptor.visibleRoot !== "string" ||
+        descriptor.visibleRoot !== capability.root ||
+        typeof capability.userId !== "string" ||
+        typeof capability.profileId !== "string" ||
+        !Array.isArray(capability.actions) ||
+        typeof capability.expiresAt !== "string" ||
+        typeof capability.credentialMode !== "string" ||
+        typeof r2.bucket !== "string" ||
+        typeof r2.endpoint !== "string" ||
+        r2.region !== "auto" ||
+        r2.forcePathStyle !== true ||
+        typeof r2.prefix !== "string" ||
+        !Array.isArray(r2.actions) ||
+        auth.mode !== "runtime-session" ||
+        auth.header !== "x-w3kits-runtime-session") {
+        throw new W3KitsContainerStorageError("invalid_storage_descriptor", "Invalid W3Kits container storage descriptor");
+    }
+    if (r2.credentials !== undefined) {
+        const credentials = record(r2.credentials, "invalid_storage_descriptor");
+        if (credentials.accessKeyId === "w3kits" ||
+            credentials.secretAccessKey === "w3kits-runtime-session") {
+            throw new W3KitsContainerStorageError("legacy_fake_credentials", "Legacy fake S3 credentials are not accepted by the SDK container bridge");
+        }
+        if (typeof credentials.accessKeyId !== "string" ||
+            typeof credentials.secretAccessKey !== "string" ||
+            typeof credentials.expiresAt !== "string") {
+            throw new W3KitsContainerStorageError("permanent_r2_credentials", "Container storage descriptors may only include expiring R2 credentials");
+        }
+    }
+    return descriptor;
+}
+/**
+ * Narrows an unknown descriptor fragment to a non-array object.
+ */
+function record(value, code) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new W3KitsContainerStorageError(code, "Invalid W3Kits container storage descriptor");
+    }
+    return value;
+}
+/**
+ * Checks whether a mapped R2 key remains inside the descriptor prefix.
+ */
+function r2KeyWithinPrefix(key, prefix) {
+    const cleanPrefix = prefix.replace(/\/+$/u, "");
+    return key === cleanPrefix || key.startsWith(`${cleanPrefix}/`);
+}
+//# sourceMappingURL=container.js.map

package/dist/container.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * W3Kits SDK root entrypoint.
+ * @owner w3kits-sdk
+ * @module sdk
+ */
+export * from "./path-mapping.js";
+export * from "./local-cache.js";
+export * from "./app-file.js";
+export * from "./profile-app-file.js";
+export * from "./storage/index.js";
+export * from "./r2-client.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+/**
+ * W3Kits SDK root entrypoint.
+ * @owner w3kits-sdk
+ * @module sdk
+ */
+export * from "./path-mapping.js";
+export * from "./local-cache.js";
+export * from "./app-file.js";
+export * from "./profile-app-file.js";
+export * from "./storage/index.js";
+export * from "./r2-client.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC"}

package/dist/local-cache.d.ts

@@ -0,0 +1,207 @@
+/**
+ * Defines SDK-owned local-first cache model and operation log helpers.
+ * @owner w3kits-sdk
+ * @module sdk
+ * @boundary local-cache
+ */
+export type LocalFirstVfsSyncState = "local" | "queued" | "syncing" | "synced" | "failed" | "conflicted";
+export type LocalFirstVfsBodyStorageKind = "indexeddb" | "opfs";
+export interface LocalFirstVfsObject {
+    id: string;
+    scopeId: string;
+    userId: string;
+    cacheGeneration: string;
+    bucket: string;
+    key: string;
+    kind: "file" | "directory";
+    size: number;
+    contentType?: string;
+    etag: string;
+    revision: string;
+    remoteRevision?: string;
+    bodyRef?: string;
+    bodyStorage?: LocalFirstVfsBodyStorageKind;
+    syncState: LocalFirstVfsSyncState;
+    updatedAt: string;
+    deletedAt?: string;
+}
+export interface LocalFirstVfsOperation {
+    operationId: string;
+    scopeId: string;
+    type: "put" | "delete" | "move" | "mkdir";
+    bucket: string;
+    key: string;
+    sourceBucket?: string;
+    sourceKey?: string;
+    bodyRef?: string;
+    contentType?: string;
+    status: "queued" | "syncing" | "synced" | "failed" | "superseded";
+    attempts: number;
+    lastError?: string;
+    nextAttemptAt?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface StoredBody {
+    bodyRef: string;
+    scopeId: string;
+    storage: LocalFirstVfsBodyStorageKind;
+    body?: ArrayBuffer;
+    opfsPath?: string;
+    size: number;
+    contentType?: string;
+    createdAt: string;
+    lastAccessedAt: string;
+}
+export interface ManifestGenerationRecord {
+    scopeId: string;
+    userId: string;
+    cacheGeneration: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface LocalFirstVfsRemote {
+    put(input: {
+        bucket: string;
+        key: string;
+        body: Uint8Array;
+        contentType?: string;
+        operationId: string;
+    }): Promise<{
+        revision?: string;
+    }>;
+    delete(input: {
+        bucket: string;
+        key: string;
+        operationId: string;
+    }): Promise<{
+        revision?: string;
+    }>;
+    move(input: {
+        sourceBucket: string;
+        sourceKey: string;
+        bucket: string;
+        key: string;
+        operationId: string;
+    }): Promise<{
+        revision?: string;
+    }>;
+    mkdir?(input: {
+        bucket: string;
+        key: string;
+        operationId: string;
+    }): Promise<{
+        revision?: string;
+    }>;
+    list?(input: {
+        bucket: string;
+        prefix: string;
+    }): Promise<{
+        objects: Array<{
+            key: string;
+            kind?: "file" | "directory";
+            size?: number;
+            contentType?: string;
+            etag?: string;
+            revision?: string;
+            updatedAt?: string;
+        }>;
+    }>;
+}
+export interface LocalFirstVfsClientOptions {
+    userId: string;
+    cacheGeneration: string;
+    remote?: LocalFirstVfsRemote;
+    bodyStore?: "auto" | "indexeddb" | "opfs";
+    inlineBodyBytes?: number;
+    retryBaseDelayMs?: number;
+    maxRetryDelayMs?: number;
+}
+export declare const DB_NAME = "w3kits-local-first-vfs";
+export declare const DB_VERSION = 2;
+export declare const OBJECT_STORE = "objects";
+export declare const BODY_STORE = "bodies";
+export declare const OPERATION_STORE = "operations";
+export declare const GENERATION_STORE = "generations";
+export declare const OPFS_ROOT = "w3kits-local-first-vfs-v1";
+export declare const OPEN_DB_TIMEOUT_MS = 2500;
+export declare const DEFAULT_INLINE_BODY_BYTES: number;
+export declare const DEFAULT_RETRY_BASE_DELAY_MS = 1000;
+export declare const DEFAULT_MAX_RETRY_DELAY_MS = 30000;
+/**
+ * Converts local-first body input to a standalone ArrayBuffer.
+ */
+export declare function toArrayBuffer(body: Uint8Array | ArrayBuffer | string): ArrayBuffer;
+/**
+ * Normalizes an object key and rejects path escapes/control characters.
+ */
+export declare function normalizeKey(input: string, options?: {
+    allowRoot?: boolean;
+}): string;
+/**
+ * Builds the local-first cache scope id.
+ */
+export declare function scopeIdFor(userId: string, cacheGeneration: string): string;
+/**
+ * Builds the stable local-first object row id.
+ */
+export declare function objectId(scopeId: string, bucket: string, key: string): string;
+/**
+ * Creates a local operation id.
+ */
+export declare function createOperationId(): string;
+/**
+ * Returns the current ISO timestamp for local-first records.
+ */
+export declare function nowIso(): string;
+/**
+ * Computes bounded exponential retry delay for failed local-first operations.
+ */
+export declare function retryDelayMs(options: LocalFirstVfsClientOptions, attempts: number): number;
+/**
+ * Computes the next retry timestamp for a failed local-first operation.
+ */
+export declare function nextAttemptIso(options: LocalFirstVfsClientOptions, attempts: number): string;
+/**
+ * Encodes an OPFS-safe path segment.
+ */
+export declare function safeOpfsSegment(value: string): string;
+/**
+ * Decides whether a body should try OPFS storage before IndexedDB storage.
+ */
+export declare function shouldTryOpfs(options: LocalFirstVfsClientOptions, bodySize: number): boolean;
+/**
+ * Filters local-first objects by scope, bucket, and prefix.
+ */
+export declare function filterLocalFirstListRows(rows: LocalFirstVfsObject[], scopeId: string, bucket: string, prefix: string): LocalFirstVfsObject[];
+/**
+ * Creates an operation log row with normalized fields.
+ */
+export declare function createQueuedOperation(input: Omit<LocalFirstVfsOperation, "operationId" | "status" | "attempts" | "createdAt" | "updatedAt"> & Partial<Pick<LocalFirstVfsOperation, "operationId" | "status" | "attempts" | "createdAt" | "updatedAt">>): LocalFirstVfsOperation;
+/**
+ * Marks a queued operation as failed because auth/capability refresh is required.
+ */
+export declare function markQueuedAuthFailure(operation: LocalFirstVfsOperation, options: LocalFirstVfsClientOptions): LocalFirstVfsOperation;
+/**
+ * In-memory operation log used by browser tests and non-persistent SDK adapters.
+ */
+export declare class InMemoryOperationLog {
+    private readonly operations;
+    /**
+     * Enqueues an operation and returns the stored row.
+     */
+    enqueue(input: Parameters<typeof createQueuedOperation>[0]): LocalFirstVfsOperation;
+    /**
+     * Lists operations that still need remote flush attempts.
+     */
+    pending(): LocalFirstVfsOperation[];
+    /**
+     * Replaces one operation row.
+     */
+    update(operation: LocalFirstVfsOperation): LocalFirstVfsOperation;
+    /**
+     * Returns all operations in insertion order.
+     */
+    all(): LocalFirstVfsOperation[];
+}
+//# sourceMappingURL=local-cache.d.ts.map

package/dist/local-cache.d.ts.map

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