@tinycloud/sdk-services 2.0.1 → 2.0.2

package/dist/kv/KVService.js

@@ -1,419 +0,0 @@
-/**
- * KVService - Key-Value storage service implementation.
- *
- * Platform-agnostic KV service that works with both web-sdk and node-sdk.
- * Uses dependency injection via IServiceContext for platform dependencies.
- */
-import { BaseService } from "../base/BaseService";
-import { ok, err, ErrorCodes, serviceError, } from "../types";
-import { authRequiredError, wrapError, storageQuotaExceededError, storageLimitReachedError, parseAuthError, authUnauthorizedError, } from "../errors";
-import { PrefixedKVService } from "./PrefixedKVService";
-import { KVAction, } from "./types";
-/**
- * KV service implementation.
- *
- * Provides key-value storage operations using TinyCloud's KV API.
- * Uses the Result type pattern for explicit error handling.
- *
- * @example
- * ```typescript
- * // Register with SDK
- * const sdk = new TinyCloud({
- *   services: { kv: KVService },
- *   serviceConfigs: { kv: { prefix: 'myapp' } },
- * });
- *
- * // Use the service
- * const result = await sdk.kv.get('settings');
- * if (result.ok) {
- *   console.log(result.data.data);
- * }
- * ```
- */
-export class KVService extends BaseService {
-    /**
-     * Create a new KVService instance.
-     *
-     * @param config - Service configuration
-     */
-    constructor(config = {}) {
-        super();
-        this._config = config;
-    }
-    /**
-     * Get the service configuration.
-     */
-    get config() {
-        return this._config;
-    }
-    // Parses "Used: X bytes, Limit: Y bytes" from tinycloud-node error responses
-    parseQuotaInfo(errorText) {
-        const match = errorText.match(/Used:\s*(\d+)\s*bytes,\s*Limit:\s*(\d+)\s*bytes/i);
-        if (match) {
-            return {
-                usedBytes: parseInt(match[1], 10),
-                limitBytes: parseInt(match[2], 10),
-            };
-        }
-        return undefined;
-    }
-    handleQuotaErrorResponse(response, errorText, key) {
-        if (response.status === 402) {
-            const quotaInfo = this.parseQuotaInfo(errorText);
-            return err(storageQuotaExceededError("kv", `Storage quota exceeded for key "${key}": ${errorText}`, {
-                status: response.status,
-                ...(quotaInfo
-                    ? { usedBytes: quotaInfo.usedBytes, limitBytes: quotaInfo.limitBytes }
-                    : {}),
-            }));
-        }
-        if (response.status === 413) {
-            const quotaInfo = this.parseQuotaInfo(errorText);
-            return err(storageLimitReachedError("kv", `Storage limit reached for key "${key}": ${errorText}`, {
-                status: response.status,
-                ...(quotaInfo
-                    ? { usedBytes: quotaInfo.usedBytes, limitBytes: quotaInfo.limitBytes }
-                    : {}),
-            }));
-        }
-        return undefined;
-    }
-    /**
-     * Get the full path with optional prefix.
-     *
-     * @param key - The key
-     * @param prefixOverride - Optional prefix override
-     * @returns The full path
-     */
-    getFullPath(key, prefixOverride) {
-        const prefix = prefixOverride ?? this._config.prefix ?? "";
-        return prefix ? `${prefix}/${key}` : key;
-    }
-    /**
-     * Get the host URL.
-     */
-    get host() {
-        return this.context.hosts[0];
-    }
-    /**
-     * Execute an invoke operation.
-     *
-     * @param path - Resource path
-     * @param action - KV action
-     * @param body - Optional request body
-     * @param signal - Optional abort signal
-     * @returns Fetch response
-     */
-    async invokeOperation(path, action, body, signal) {
-        const session = this.context.session;
-        const headers = this.context.invoke(session, "kv", path, action);
-        return this.context.fetch(`${this.host}/invoke`, {
-            method: "POST",
-            headers,
-            body,
-            signal: this.combineSignals(signal),
-        });
-    }
-    /**
-     * Create KVResponseHeaders from fetch response headers.
-     *
-     * @param headers - Fetch response headers
-     * @returns KVResponseHeaders object
-     */
-    createResponseHeaders(headers) {
-        return {
-            etag: headers.get("etag") ?? undefined,
-            contentType: headers.get("content-type") ?? undefined,
-            lastModified: headers.get("last-modified") ?? undefined,
-            contentLength: headers.get("content-length")
-                ? parseInt(headers.get("content-length"), 10)
-                : undefined,
-            get: (name) => headers.get(name),
-        };
-    }
-    /**
-     * Parse response body based on content type.
-     *
-     * @param response - Fetch response
-     * @param raw - Whether to return raw text
-     * @returns Parsed data
-     */
-    async parseResponse(response, raw = false) {
-        if (!response.ok) {
-            return undefined;
-        }
-        if (raw) {
-            return (await response.text());
-        }
-        const contentType = response.headers.get("content-type");
-        if (contentType?.includes("application/json")) {
-            return (await response.json());
-        }
-        else if (contentType?.startsWith("text/")) {
-            return (await response.text());
-        }
-        // No content-type header - try to parse as JSON, fall back to text
-        const text = await response.text();
-        if (!text) {
-            return undefined;
-        }
-        try {
-            return JSON.parse(text);
-        }
-        catch {
-            return text;
-        }
-    }
-    /**
-     * Get a value by key.
-     */
-    async get(key, options) {
-        return this.withTelemetry("get", key, async () => {
-            if (!this.requireAuth()) {
-                return err(authRequiredError("kv"));
-            }
-            const path = this.getFullPath(key, options?.prefix);
-            try {
-                const response = await this.invokeOperation(path, KVAction.GET, undefined, options?.signal);
-                if (!response.ok) {
-                    if (response.status === 401) {
-                        const errorText = await response.text();
-                        const { resource, action } = parseAuthError(errorText);
-                        return err(authUnauthorizedError("kv", errorText, {
-                            status: response.status,
-                            ...(action && { requiredAction: action }),
-                            ...(resource && { resource }),
-                        }));
-                    }
-                    if (response.status === 404) {
-                        return err(serviceError(ErrorCodes.KV_NOT_FOUND, `Key not found: ${key}`, "kv"));
-                    }
-                    const errorText = await response.text();
-                    return err(serviceError(ErrorCodes.NETWORK_ERROR, `Failed to get key "${key}": ${response.status} - ${errorText}`, "kv", { meta: { status: response.status, statusText: response.statusText } }));
-                }
-                const data = await this.parseResponse(response, options?.raw);
-                return ok({
-                    data: data,
-                    headers: this.createResponseHeaders(response.headers),
-                });
-            }
-            catch (error) {
-                return err(wrapError("kv", error));
-            }
-        });
-    }
-    /**
-     * Store a value at a key.
-     */
-    async put(key, value, options) {
-        return this.withTelemetry("put", key, async () => {
-            if (!this.requireAuth()) {
-                return err(authRequiredError("kv"));
-            }
-            const path = this.getFullPath(key, options?.prefix);
-            // Serialize value to string
-            let body;
-            if (typeof value === "string") {
-                body = value;
-            }
-            else {
-                body = JSON.stringify(value);
-            }
-            try {
-                const response = await this.invokeOperation(path, KVAction.PUT, body, options?.signal);
-                if (!response.ok) {
-                    if (response.status === 401) {
-                        const errorText = await response.text();
-                        const { resource, action } = parseAuthError(errorText);
-                        return err(authUnauthorizedError("kv", errorText, {
-                            status: response.status,
-                            ...(action && { requiredAction: action }),
-                            ...(resource && { resource }),
-                        }));
-                    }
-                    const errorText = await response.text();
-                    // Check for storage quota errors (402, 413)
-                    const quotaError = this.handleQuotaErrorResponse(response, errorText, key);
-                    if (quotaError) {
-                        return quotaError;
-                    }
-                    return err(serviceError(ErrorCodes.KV_WRITE_FAILED, `Failed to put key "${key}": ${response.status} - ${errorText}`, "kv", { meta: { status: response.status, statusText: response.statusText } }));
-                }
-                return ok({
-                    data: undefined,
-                    headers: this.createResponseHeaders(response.headers),
-                });
-            }
-            catch (error) {
-                return err(wrapError("kv", error));
-            }
-        });
-    }
-    /**
-     * List keys with optional prefix filtering.
-     */
-    async list(options) {
-        return this.withTelemetry("list", options?.prefix, async () => {
-            if (!this.requireAuth()) {
-                return err(authRequiredError("kv"));
-            }
-            // Build the path from prefix and optional path
-            let listPath = options?.prefix ?? this._config.prefix ?? "";
-            if (options?.path) {
-                listPath = listPath ? `${listPath}/${options.path}` : options.path;
-            }
-            try {
-                const response = await this.invokeOperation(listPath, KVAction.LIST, undefined, options?.signal);
-                if (!response.ok) {
-                    if (response.status === 401) {
-                        const errorText = await response.text();
-                        const { resource, action } = parseAuthError(errorText);
-                        return err(authUnauthorizedError("kv", errorText, {
-                            status: response.status,
-                            ...(action && { requiredAction: action }),
-                            ...(resource && { resource }),
-                        }));
-                    }
-                    const errorText = await response.text();
-                    return err(serviceError(ErrorCodes.NETWORK_ERROR, `Failed to list keys: ${response.status} - ${errorText}`, "kv", { meta: { status: response.status, statusText: response.statusText } }));
-                }
-                let keys = await this.parseResponse(response, options?.raw);
-                keys = keys ?? [];
-                // Optionally remove prefix from keys
-                if (options?.removePrefix && listPath) {
-                    const prefixWithSlash = listPath.endsWith("/")
-                        ? listPath
-                        : `${listPath}/`;
-                    keys = keys.map((key) => key.startsWith(prefixWithSlash)
-                        ? key.slice(prefixWithSlash.length)
-                        : key);
-                }
-                return ok({ keys });
-            }
-            catch (error) {
-                return err(wrapError("kv", error));
-            }
-        });
-    }
-    /**
-     * Delete a key.
-     */
-    async delete(key, options) {
-        return this.withTelemetry("delete", key, async () => {
-            if (!this.requireAuth()) {
-                return err(authRequiredError("kv"));
-            }
-            const path = this.getFullPath(key, options?.prefix);
-            try {
-                const response = await this.invokeOperation(path, KVAction.DELETE, undefined, options?.signal);
-                if (!response.ok) {
-                    if (response.status === 401) {
-                        const errorText = await response.text();
-                        const { resource, action } = parseAuthError(errorText);
-                        return err(authUnauthorizedError("kv", errorText, {
-                            status: response.status,
-                            ...(action && { requiredAction: action }),
-                            ...(resource && { resource }),
-                        }));
-                    }
-                    if (response.status === 404) {
-                        return err(serviceError(ErrorCodes.KV_NOT_FOUND, `Key not found: ${key}`, "kv"));
-                    }
-                    const errorText = await response.text();
-                    return err(serviceError(ErrorCodes.NETWORK_ERROR, `Failed to delete key "${key}": ${response.status} - ${errorText}`, "kv", { meta: { status: response.status, statusText: response.statusText } }));
-                }
-                return ok(undefined);
-            }
-            catch (error) {
-                return err(wrapError("kv", error));
-            }
-        });
-    }
-    /**
-     * Get metadata for a key without retrieving the value.
-     */
-    async head(key, options) {
-        return this.withTelemetry("head", key, async () => {
-            if (!this.requireAuth()) {
-                return err(authRequiredError("kv"));
-            }
-            const path = this.getFullPath(key, options?.prefix);
-            try {
-                const response = await this.invokeOperation(path, KVAction.HEAD, undefined, options?.signal);
-                if (!response.ok) {
-                    if (response.status === 401) {
-                        const errorText = await response.text();
-                        const { resource, action } = parseAuthError(errorText);
-                        return err(authUnauthorizedError("kv", errorText, {
-                            status: response.status,
-                            ...(action && { requiredAction: action }),
-                            ...(resource && { resource }),
-                        }));
-                    }
-                    if (response.status === 404) {
-                        return err(serviceError(ErrorCodes.KV_NOT_FOUND, `Key not found: ${key}`, "kv"));
-                    }
-                    const errorText = await response.text();
-                    return err(serviceError(ErrorCodes.NETWORK_ERROR, `Failed to get metadata for key "${key}": ${response.status} - ${errorText}`, "kv", { meta: { status: response.status, statusText: response.statusText } }));
-                }
-                return ok({
-                    data: undefined,
-                    headers: this.createResponseHeaders(response.headers),
-                });
-            }
-            catch (error) {
-                return err(wrapError("kv", error));
-            }
-        });
-    }
-    /**
-     * Create a prefix-scoped view of this KV service.
-     *
-     * Returns a PrefixedKVService that automatically prefixes all
-     * key operations with the specified prefix. This enables apps
-     * to isolate their data within a shared space.
-     *
-     * @param prefix - The prefix to apply to all operations
-     * @returns A PrefixedKVService scoped to the prefix
-     *
-     * ## Prefix Conventions
-     *
-     * | Pattern | Use Case | Example |
-     * | -- | -- | -- |
-     * | `/app.{domain}/` | App-private data | `/app.photos.xyz/settings.json` |
-     * | `/{type}/` | Shared data type | `/photos/vacation.jpg` |
-     * | `/.{name}/` | Hidden/system data | `/.cache/thumbnails/` |
-     * | `/public/` | Explicitly shareable | `/public/profile.json` |
-     *
-     * @example
-     * ```typescript
-     * const space = sdk.space('default');
-     *
-     * // Create prefix-scoped views
-     * const myApp = space.kv.withPrefix('/app.myapp.com');
-     * const sharedPhotos = space.kv.withPrefix('/photos');
-     *
-     * // Operations are automatically prefixed
-     * await myApp.put('settings.json', { theme: 'dark' });
-     * // -> Actually writes to: /app.myapp.com/settings.json
-     *
-     * await myApp.get('settings.json');
-     * // -> Actually reads from: /app.myapp.com/settings.json
-     *
-     * await sharedPhotos.list();
-     * // -> Lists: /photos/*
-     *
-     * // Nested prefixes
-     * const settings = myApp.withPrefix('/settings');
-     * await settings.get('theme.json');  // -> /app.myapp.com/settings/theme.json
-     * ```
-     */
-    withPrefix(prefix) {
-        return new PrefixedKVService(this, prefix);
-    }
-}
-/**
- * Service identifier for registration.
- */
-KVService.serviceName = "kv";
-//# sourceMappingURL=KVService.js.map

package/dist/kv/KVService.js.map

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

package/dist/kv/PrefixedKVService.d.ts

@@ -1,246 +0,0 @@
-/**
- * PrefixedKVService - A prefix-scoped view of KVService.
- *
- * Provides key-value operations scoped to a specific prefix.
- * All operations automatically prefix keys, enabling app data isolation
- * within a shared space.
- *
- * @example
- * ```typescript
- * const space = sdk.space('default');
- *
- * // Create prefix-scoped views
- * const myApp = space.kv.withPrefix('/app.myapp.com');
- * const sharedPhotos = space.kv.withPrefix('/photos');
- *
- * // Operations are automatically prefixed
- * await myApp.put('settings.json', { theme: 'dark' });
- * // -> Actually writes to: /app.myapp.com/settings.json
- *
- * await myApp.get('settings.json');
- * // -> Actually reads from: /app.myapp.com/settings.json
- *
- * await sharedPhotos.list();
- * // -> Lists: /photos/*
- *
- * // Nested prefixes
- * const settings = myApp.withPrefix('/settings');
- * await settings.get('theme.json');  // -> /app.myapp.com/settings/theme.json
- * ```
- */
-import { Result } from "../types";
-import { KVGetOptions, KVPutOptions, KVListOptions, KVDeleteOptions, KVHeadOptions, KVResponse, KVListResponse } from "./types";
-/**
- * Interface for prefixed KV operations.
- *
- * Provides the same operations as IKVService but scoped to a prefix.
- * Supports nested prefixes via withPrefix().
- */
-export interface IPrefixedKVService {
-    /**
-     * The current prefix for this scoped view.
-     */
-    readonly prefix: string;
-    /**
-     * Get a value by key.
-     *
-     * The key is automatically prefixed with this service's prefix.
-     *
-     * @param key - The key to retrieve (will be prefixed)
-     * @param options - Optional get configuration
-     * @returns Result with the stored value and headers
-     *
-     * @example
-     * ```typescript
-     * const myApp = kv.withPrefix('/app.myapp.com');
-     * const result = await myApp.get('settings.json');
-     * // -> Reads from: /app.myapp.com/settings.json
-     * ```
-     */
-    get<T = unknown>(key: string, options?: Omit<KVGetOptions, 'prefix'>): Promise<Result<KVResponse<T>>>;
-    /**
-     * Store a value at a key.
-     *
-     * The key is automatically prefixed with this service's prefix.
-     *
-     * @param key - The key to store under (will be prefixed)
-     * @param value - The value to store
-     * @param options - Optional put configuration
-     * @returns Result indicating success/failure
-     *
-     * @example
-     * ```typescript
-     * const myApp = kv.withPrefix('/app.myapp.com');
-     * await myApp.put('settings.json', { theme: 'dark' });
-     * // -> Stores at: /app.myapp.com/settings.json
-     * ```
-     */
-    put(key: string, value: unknown, options?: Omit<KVPutOptions, 'prefix'>): Promise<Result<KVResponse<void>>>;
-    /**
-     * List keys within this prefix.
-     *
-     * Returns keys that match the prefix, with keys returned relative
-     * to the prefix when removePrefix is true (default for prefixed service).
-     *
-     * @param options - Optional list configuration
-     * @returns Result with array of matching keys
-     *
-     * @example
-     * ```typescript
-     * const myApp = kv.withPrefix('/app.myapp.com');
-     * const result = await myApp.list();
-     * // -> Lists keys under: /app.myapp.com/*
-     * // Returns: ['settings.json', 'data/user.json', ...]
-     * ```
-     */
-    list(options?: Omit<KVListOptions, 'prefix'>): Promise<Result<KVListResponse>>;
-    /**
-     * Delete a key.
-     *
-     * The key is automatically prefixed with this service's prefix.
-     *
-     * @param key - The key to delete (will be prefixed)
-     * @param options - Optional delete configuration
-     * @returns Result indicating success/failure
-     *
-     * @example
-     * ```typescript
-     * const myApp = kv.withPrefix('/app.myapp.com');
-     * await myApp.delete('old-settings.json');
-     * // -> Deletes: /app.myapp.com/old-settings.json
-     * ```
-     */
-    delete(key: string, options?: Omit<KVDeleteOptions, 'prefix'>): Promise<Result<void>>;
-    /**
-     * Get metadata for a key without retrieving the value.
-     *
-     * The key is automatically prefixed with this service's prefix.
-     *
-     * @param key - The key to check (will be prefixed)
-     * @param options - Optional head configuration
-     * @returns Result with headers only
-     *
-     * @example
-     * ```typescript
-     * const myApp = kv.withPrefix('/app.myapp.com');
-     * const result = await myApp.head('large-file.bin');
-     * // -> Gets metadata for: /app.myapp.com/large-file.bin
-     * ```
-     */
-    head(key: string, options?: Omit<KVHeadOptions, 'prefix'>): Promise<Result<KVResponse<void>>>;
-    /**
-     * Create a nested prefix-scoped view.
-     *
-     * The subPrefix is appended to the current prefix.
-     *
-     * @param subPrefix - The sub-prefix to append
-     * @returns A new PrefixedKVService with the combined prefix
-     *
-     * @example
-     * ```typescript
-     * const myApp = kv.withPrefix('/app.myapp.com');
-     * const settings = myApp.withPrefix('/settings');
-     * await settings.get('theme.json');
-     * // -> Reads from: /app.myapp.com/settings/theme.json
-     * ```
-     */
-    withPrefix(subPrefix: string): IPrefixedKVService;
-}
-/**
- * Interface for a KV service that supports prefix delegation.
- *
- * This is the subset of IKVService methods needed by PrefixedKVService.
- */
-interface IKVServiceLike {
-    get<T = unknown>(key: string, options?: KVGetOptions): Promise<Result<KVResponse<T>>>;
-    put(key: string, value: unknown, options?: KVPutOptions): Promise<Result<KVResponse<void>>>;
-    list(options?: KVListOptions): Promise<Result<KVListResponse>>;
-    delete(key: string, options?: KVDeleteOptions): Promise<Result<void>>;
-    head(key: string, options?: KVHeadOptions): Promise<Result<KVResponse<void>>>;
-}
-/**
- * PrefixedKVService - Implementation of prefix-scoped KV operations.
- *
- * This class wraps a KVService (or another PrefixedKVService) and
- * automatically prefixes all key operations with the configured prefix.
- *
- * ## Prefix Convention
- *
- * | Pattern | Use Case | Example |
- * | -- | -- | -- |
- * | `/app.{domain}/` | App-private data | `/app.photos.xyz/settings.json` |
- * | `/{type}/` | Shared data type | `/photos/vacation.jpg` |
- * | `/.{name}/` | Hidden/system data | `/.cache/thumbnails/` |
- * | `/public/` | Explicitly shareable | `/public/profile.json` |
- *
- * @example
- * ```typescript
- * // Create from KVService
- * const prefixed = new PrefixedKVService(kvService, '/app.myapp.com');
- *
- * // Or use the withPrefix factory method on KVService
- * const prefixed = kvService.withPrefix('/app.myapp.com');
- *
- * // All operations are automatically prefixed
- * await prefixed.put('settings.json', { theme: 'dark' });
- * await prefixed.get('settings.json');
- *
- * // Nested prefixes
- * const nested = prefixed.withPrefix('/settings');
- * await nested.get('theme.json');  // -> /app.myapp.com/settings/theme.json
- * ```
- */
-export declare class PrefixedKVService implements IPrefixedKVService {
-    /**
-     * The underlying KV service.
-     */
-    private readonly _kv;
-    /**
-     * The prefix for this scoped view.
-     */
-    private readonly _prefix;
-    /**
-     * Create a new PrefixedKVService.
-     *
-     * @param kv - The underlying KV service to delegate to
-     * @param prefix - The prefix to apply to all operations
-     */
-    constructor(kv: IKVServiceLike, prefix: string);
-    /**
-     * The current prefix for this scoped view.
-     */
-    get prefix(): string;
-    /**
-     * Compute the full key path by combining prefix and key.
-     *
-     * @param key - The key to prefix
-     * @returns The full path including prefix
-     */
-    private getFullKey;
-    /**
-     * Get a value by key.
-     */
-    get<T = unknown>(key: string, options?: Omit<KVGetOptions, 'prefix'>): Promise<Result<KVResponse<T>>>;
-    /**
-     * Store a value at a key.
-     */
-    put(key: string, value: unknown, options?: Omit<KVPutOptions, 'prefix'>): Promise<Result<KVResponse<void>>>;
-    /**
-     * List keys within this prefix.
-     */
-    list(options?: Omit<KVListOptions, 'prefix'>): Promise<Result<KVListResponse>>;
-    /**
-     * Delete a key.
-     */
-    delete(key: string, options?: Omit<KVDeleteOptions, 'prefix'>): Promise<Result<void>>;
-    /**
-     * Get metadata for a key without retrieving the value.
-     */
-    head(key: string, options?: Omit<KVHeadOptions, 'prefix'>): Promise<Result<KVResponse<void>>>;
-    /**
-     * Create a nested prefix-scoped view.
-     */
-    withPrefix(subPrefix: string): IPrefixedKVService;
-}
-export {};
-//# sourceMappingURL=PrefixedKVService.d.ts.map