@tinycloud/sdk-services 2.0.3 → 2.1.0-beta.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { I as IServiceContext, a as InvokeFunction, F as FetchFunction, S as ServiceSession, R as RetryPolicy, b as IService, c as ServiceError, d as Result, B as BaseService, e as StorageQuotaInfo } from './BaseService-D9BFm_rV.cjs';
-export { E as ErrorCode, f as ErrorCodes, g as EventHandler, h as FetchRequestInit, i as FetchResponse, j as InvocationFact, k as InvocationFacts, l as ServiceErrorEvent, m as ServiceHeaders, n as ServiceRequestEvent, o as ServiceResponseEvent, p as ServiceRetryEvent, T as TelemetryEvents, q as defaultRetryPolicy, r as err, s as ok, t as serviceError } from './BaseService-D9BFm_rV.cjs';
+import { I as IServiceContext, a as InvokeFunction, b as InvokeAnyFunction, F as FetchFunction, S as ServiceSession, R as RetryPolicy, c as IService, d as ServiceError, e as Result, B as BaseService, f as StorageQuotaInfo } from './BaseService-BiS6HRwE.cjs';
+export { E as ErrorCode, g as ErrorCodes, h as EventHandler, i as FetchRequestInit, j as FetchResponse, k as InvocationFact, l as InvocationFacts, m as InvokeAnyEntry, n as ServiceErrorEvent, o as ServiceHeaders, p as ServiceRequestEvent, q as ServiceResponseEvent, r as ServiceRetryEvent, T as TelemetryEvents, s as defaultRetryPolicy, t as err, u as ok, v as serviceError } from './BaseService-BiS6HRwE.cjs';
 import { z } from 'zod';
 import { IKVService } from './kv/index.cjs';
 export { IPrefixedKVService, KVAction, KVActionType, KVDeleteOptions, KVGetOptions, KVHeadOptions, KVListOptions, KVListResponse, KVPutOptions, KVResponse, KVResponseHeaders, KVService, KVServiceConfig, PrefixedKVService } from './kv/index.cjs';
@@ -732,6 +732,8 @@ type EventHandler = (data: unknown) => void;
 interface ServiceContextConfig {
     /** Function to invoke WASM operations */
     invoke: InvokeFunction;
+    /** Optional function to mint a single authorization header for multiple capabilities */
+    invokeAny?: InvokeAnyFunction;
     /** Function to make HTTP requests (defaults to globalThis.fetch) */
     fetch?: FetchFunction;
     /** List of TinyCloud host URLs */
@@ -768,6 +770,7 @@ declare class ServiceContext implements IServiceContext {
     private _eventHandlers;
     private _abortController;
     private readonly _invoke;
+    private readonly _invokeAny?;
     private readonly _fetch;
     private readonly _hosts;
     private readonly _retryPolicy;
@@ -790,6 +793,10 @@ declare class ServiceContext implements IServiceContext {
      * Get the invoke function for WASM operations.
      */
     get invoke(): InvokeFunction;
+    /**
+     * Get the multi-resource invoke function when available.
+     */
+    get invokeAny(): InvokeAnyFunction | undefined;
     /**
      * Get the fetch function for HTTP requests.
      */
@@ -1247,6 +1254,96 @@ declare class DuckDbDatabaseHandle implements IDuckDbDatabaseHandle {
     import(data: Uint8Array, options?: DuckDbOptions): Promise<Result<void>>;
 }
 
+type HookServiceName = "kv" | "sql" | "duckdb";
+interface HookSubscription {
+    space: string;
+    service: HookServiceName;
+    pathPrefix?: string;
+    abilities?: string[];
+}
+interface HookWebhookScope {
+    space: string;
+    service: HookServiceName;
+    pathPrefix?: string;
+    abilities?: string[];
+}
+interface HookWebhookRegistration extends HookWebhookScope {
+    callbackUrl: string;
+    secret: string;
+}
+interface HookWebhookRecord extends HookWebhookScope {
+    id: string;
+    subscriberDid?: string;
+    callbackUrl: string;
+    active: boolean;
+    createdAt: string;
+}
+interface HookWebhookListOptions {
+    space?: string;
+    service?: HookServiceName;
+    pathPrefix?: string;
+}
+interface HookWebhookUnregisterOptions {
+    target?: HookWebhookScope;
+}
+interface HookEvent {
+    type: "write";
+    id: string;
+    space: string;
+    service: string;
+    ability: string;
+    path?: string;
+    actor: string;
+    epoch: string;
+    eventIndex: number;
+    timestamp: string;
+}
+interface HookStreamEvent {
+    event: string;
+    data: string;
+    id?: string;
+}
+interface SubscribeOptions {
+    ttlSeconds?: number;
+    signal?: AbortSignal;
+}
+interface HooksServiceConfig extends Record<string, unknown> {
+    host?: string;
+}
+
+interface IHooksService {
+    subscribe(subscriptions: HookSubscription[], options?: SubscribeOptions): AsyncIterable<HookEvent>;
+    register(webhook: HookWebhookRegistration): Promise<Result<HookWebhookRecord>>;
+    list(options?: HookWebhookListOptions): Promise<Result<HookWebhookRecord[]>>;
+    unregister(id: string, options?: HookWebhookUnregisterOptions): Promise<Result<void>>;
+}
+
+declare class HooksService extends BaseService implements IHooksService {
+    static readonly serviceName = "hooks";
+    protected _config: HooksServiceConfig;
+    private readonly _subscribers;
+    private _sharedStreamTask?;
+    private _sharedStreamAbort?;
+    private _refreshChain;
+    private _activeSignature;
+    constructor(config?: HooksServiceConfig);
+    get config(): HooksServiceConfig;
+    private get host();
+    subscribe(subscriptions: HookSubscription[], options?: SubscribeOptions): AsyncIterable<HookEvent>;
+    register(webhook: HookWebhookRegistration): Promise<Result<HookWebhookRecord>>;
+    list(options?: HookWebhookListOptions): Promise<Result<HookWebhookRecord[]>>;
+    unregister(id: string, options?: HookWebhookUnregisterOptions): Promise<Result<void>>;
+    private scheduleSharedStreamRefresh;
+    private refreshSharedStream;
+    private collectSharedStreamState;
+    private runSharedStream;
+    private abortSharedStream;
+    private createHookHeaders;
+    private mintHookTicket;
+    private openHookStream;
+    private createInvokeHeaders;
+}
+
 interface QuotaConfig {
     /** Called when a storage quota error is detected (402/413) */
     onUpgradeRequired?: (info: StorageQuotaInfo) => void;
@@ -1840,4 +1937,4 @@ interface WasmVaultFunctions {
 }
 declare function createVaultCrypto(wasm: WasmVaultFunctions): VaultCrypto;
 
-export { BaseService, type BaseServiceOptions, type ColumnInfo, type DataVaultConfig, DataVaultService, DuckDbAction, type DuckDbActionType, type DuckDbBatchOptions, type BatchResponse as DuckDbBatchResponse, DuckDbDatabaseHandle, type DuckDbExecuteOptions, type ExecuteResponse as DuckDbExecuteResponse, type DuckDbOptions, type DuckDbQueryOptions, type QueryResponse as DuckDbQueryResponse, DuckDbService, type DuckDbServiceConfig, type DuckDbStatement, type DuckDbValue, FetchFunction, GenericKVResponseSchema, type GenericKVResponseType, GenericResultSchema, type IDataVaultService, type IDuckDbDatabaseHandle, type IDuckDbService, IKVService, IService, IServiceContext, InvokeFunction, KVListResponseSchema, type KVListResponseType, KVListResultSchema, type KVListResultType, KVResponseHeadersSchema, type KVResponseHeadersType, type QuotaConfig, type QuotaStatus, Result, RetryPolicy, RetryPolicySchema, type RetryPolicyType, type SchemaInfo, type ServiceConstructor, ServiceContext, type ServiceContextConfig, ServiceError, ServiceErrorEventSchema, type ServiceErrorEventType, ServiceErrorSchema, type ServiceErrorType, type ServiceRegistration, ServiceRequestEventSchema, type ServiceRequestEventType, ServiceResponseEventSchema, type ServiceResponseEventType, ServiceRetryEventSchema, type ServiceRetryEventType, ServiceSession, ServiceSessionSchema, type ServiceSessionType, StorageQuotaInfo, type TableInfo, TinyCloudQuota, type ValidationError, type VaultCrypto, type VaultEntry, type VaultError, type VaultGetOptions, type VaultGrantOptions, VaultHeaders, type VaultListOptions, VaultPublicSpaceKVActions, type VaultPutOptions, type ViewInfo, type WasmVaultFunctions, abortedError, authExpiredError, authRequiredError, authUnauthorizedError, createKVResponseSchema, createResultSchema, createVaultCrypto, errorResult, networkError, notFoundError, parseAuthError, permissionDeniedError, storageLimitReachedError, storageQuotaExceededError, timeoutError, validateKVListResponse, validateKVResponseHeaders, validateRetryPolicy, validateServiceError, validateServiceRequestEvent, validateServiceResponseEvent, validateServiceSession, wrapError };
+export { BaseService, type BaseServiceOptions, type ColumnInfo, type DataVaultConfig, DataVaultService, DuckDbAction, type DuckDbActionType, type DuckDbBatchOptions, type BatchResponse as DuckDbBatchResponse, DuckDbDatabaseHandle, type DuckDbExecuteOptions, type ExecuteResponse as DuckDbExecuteResponse, type DuckDbOptions, type DuckDbQueryOptions, type QueryResponse as DuckDbQueryResponse, DuckDbService, type DuckDbServiceConfig, type DuckDbStatement, type DuckDbValue, FetchFunction, GenericKVResponseSchema, type GenericKVResponseType, GenericResultSchema, type HookEvent, type HookServiceName, type HookStreamEvent, type HookSubscription, type HookWebhookListOptions, type HookWebhookRecord, type HookWebhookRegistration, type HookWebhookScope, type HookWebhookUnregisterOptions, HooksService, type HooksServiceConfig, type IDataVaultService, type IDuckDbDatabaseHandle, type IDuckDbService, type IHooksService, IKVService, IService, IServiceContext, InvokeAnyFunction, InvokeFunction, KVListResponseSchema, type KVListResponseType, KVListResultSchema, type KVListResultType, KVResponseHeadersSchema, type KVResponseHeadersType, type QuotaConfig, type QuotaStatus, Result, RetryPolicy, RetryPolicySchema, type RetryPolicyType, type SchemaInfo, type ServiceConstructor, ServiceContext, type ServiceContextConfig, ServiceError, ServiceErrorEventSchema, type ServiceErrorEventType, ServiceErrorSchema, type ServiceErrorType, type ServiceRegistration, ServiceRequestEventSchema, type ServiceRequestEventType, ServiceResponseEventSchema, type ServiceResponseEventType, ServiceRetryEventSchema, type ServiceRetryEventType, ServiceSession, ServiceSessionSchema, type ServiceSessionType, StorageQuotaInfo, type SubscribeOptions, type TableInfo, TinyCloudQuota, type ValidationError, type VaultCrypto, type VaultEntry, type VaultError, type VaultGetOptions, type VaultGrantOptions, VaultHeaders, type VaultListOptions, VaultPublicSpaceKVActions, type VaultPutOptions, type ViewInfo, type WasmVaultFunctions, abortedError, authExpiredError, authRequiredError, authUnauthorizedError, createKVResponseSchema, createResultSchema, createVaultCrypto, errorResult, networkError, notFoundError, parseAuthError, permissionDeniedError, storageLimitReachedError, storageQuotaExceededError, timeoutError, validateKVListResponse, validateKVResponseHeaders, validateRetryPolicy, validateServiceError, validateServiceRequestEvent, validateServiceResponseEvent, validateServiceSession, wrapError };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { I as IServiceContext, a as InvokeFunction, F as FetchFunction, S as ServiceSession, R as RetryPolicy, b as IService, c as ServiceError, d as Result, B as BaseService, e as StorageQuotaInfo } from './BaseService-D9BFm_rV.js';
-export { E as ErrorCode, f as ErrorCodes, g as EventHandler, h as FetchRequestInit, i as FetchResponse, j as InvocationFact, k as InvocationFacts, l as ServiceErrorEvent, m as ServiceHeaders, n as ServiceRequestEvent, o as ServiceResponseEvent, p as ServiceRetryEvent, T as TelemetryEvents, q as defaultRetryPolicy, r as err, s as ok, t as serviceError } from './BaseService-D9BFm_rV.js';
+import { I as IServiceContext, a as InvokeFunction, b as InvokeAnyFunction, F as FetchFunction, S as ServiceSession, R as RetryPolicy, c as IService, d as ServiceError, e as Result, B as BaseService, f as StorageQuotaInfo } from './BaseService-BiS6HRwE.js';
+export { E as ErrorCode, g as ErrorCodes, h as EventHandler, i as FetchRequestInit, j as FetchResponse, k as InvocationFact, l as InvocationFacts, m as InvokeAnyEntry, n as ServiceErrorEvent, o as ServiceHeaders, p as ServiceRequestEvent, q as ServiceResponseEvent, r as ServiceRetryEvent, T as TelemetryEvents, s as defaultRetryPolicy, t as err, u as ok, v as serviceError } from './BaseService-BiS6HRwE.js';
 import { z } from 'zod';
 import { IKVService } from './kv/index.js';
 export { IPrefixedKVService, KVAction, KVActionType, KVDeleteOptions, KVGetOptions, KVHeadOptions, KVListOptions, KVListResponse, KVPutOptions, KVResponse, KVResponseHeaders, KVService, KVServiceConfig, PrefixedKVService } from './kv/index.js';
@@ -732,6 +732,8 @@ type EventHandler = (data: unknown) => void;
 interface ServiceContextConfig {
     /** Function to invoke WASM operations */
     invoke: InvokeFunction;
+    /** Optional function to mint a single authorization header for multiple capabilities */
+    invokeAny?: InvokeAnyFunction;
     /** Function to make HTTP requests (defaults to globalThis.fetch) */
     fetch?: FetchFunction;
     /** List of TinyCloud host URLs */
@@ -768,6 +770,7 @@ declare class ServiceContext implements IServiceContext {
     private _eventHandlers;
     private _abortController;
     private readonly _invoke;
+    private readonly _invokeAny?;
     private readonly _fetch;
     private readonly _hosts;
     private readonly _retryPolicy;
@@ -790,6 +793,10 @@ declare class ServiceContext implements IServiceContext {
      * Get the invoke function for WASM operations.
      */
     get invoke(): InvokeFunction;
+    /**
+     * Get the multi-resource invoke function when available.
+     */
+    get invokeAny(): InvokeAnyFunction | undefined;
     /**
      * Get the fetch function for HTTP requests.
      */
@@ -1247,6 +1254,96 @@ declare class DuckDbDatabaseHandle implements IDuckDbDatabaseHandle {
     import(data: Uint8Array, options?: DuckDbOptions): Promise<Result<void>>;
 }
 
+type HookServiceName = "kv" | "sql" | "duckdb";
+interface HookSubscription {
+    space: string;
+    service: HookServiceName;
+    pathPrefix?: string;
+    abilities?: string[];
+}
+interface HookWebhookScope {
+    space: string;
+    service: HookServiceName;
+    pathPrefix?: string;
+    abilities?: string[];
+}
+interface HookWebhookRegistration extends HookWebhookScope {
+    callbackUrl: string;
+    secret: string;
+}
+interface HookWebhookRecord extends HookWebhookScope {
+    id: string;
+    subscriberDid?: string;
+    callbackUrl: string;
+    active: boolean;
+    createdAt: string;
+}
+interface HookWebhookListOptions {
+    space?: string;
+    service?: HookServiceName;
+    pathPrefix?: string;
+}
+interface HookWebhookUnregisterOptions {
+    target?: HookWebhookScope;
+}
+interface HookEvent {
+    type: "write";
+    id: string;
+    space: string;
+    service: string;
+    ability: string;
+    path?: string;
+    actor: string;
+    epoch: string;
+    eventIndex: number;
+    timestamp: string;
+}
+interface HookStreamEvent {
+    event: string;
+    data: string;
+    id?: string;
+}
+interface SubscribeOptions {
+    ttlSeconds?: number;
+    signal?: AbortSignal;
+}
+interface HooksServiceConfig extends Record<string, unknown> {
+    host?: string;
+}
+
+interface IHooksService {
+    subscribe(subscriptions: HookSubscription[], options?: SubscribeOptions): AsyncIterable<HookEvent>;
+    register(webhook: HookWebhookRegistration): Promise<Result<HookWebhookRecord>>;
+    list(options?: HookWebhookListOptions): Promise<Result<HookWebhookRecord[]>>;
+    unregister(id: string, options?: HookWebhookUnregisterOptions): Promise<Result<void>>;
+}
+
+declare class HooksService extends BaseService implements IHooksService {
+    static readonly serviceName = "hooks";
+    protected _config: HooksServiceConfig;
+    private readonly _subscribers;
+    private _sharedStreamTask?;
+    private _sharedStreamAbort?;
+    private _refreshChain;
+    private _activeSignature;
+    constructor(config?: HooksServiceConfig);
+    get config(): HooksServiceConfig;
+    private get host();
+    subscribe(subscriptions: HookSubscription[], options?: SubscribeOptions): AsyncIterable<HookEvent>;
+    register(webhook: HookWebhookRegistration): Promise<Result<HookWebhookRecord>>;
+    list(options?: HookWebhookListOptions): Promise<Result<HookWebhookRecord[]>>;
+    unregister(id: string, options?: HookWebhookUnregisterOptions): Promise<Result<void>>;
+    private scheduleSharedStreamRefresh;
+    private refreshSharedStream;
+    private collectSharedStreamState;
+    private runSharedStream;
+    private abortSharedStream;
+    private createHookHeaders;
+    private mintHookTicket;
+    private openHookStream;
+    private createInvokeHeaders;
+}
+
 interface QuotaConfig {
     /** Called when a storage quota error is detected (402/413) */
     onUpgradeRequired?: (info: StorageQuotaInfo) => void;
@@ -1840,4 +1937,4 @@ interface WasmVaultFunctions {
 }
 declare function createVaultCrypto(wasm: WasmVaultFunctions): VaultCrypto;
 
-export { BaseService, type BaseServiceOptions, type ColumnInfo, type DataVaultConfig, DataVaultService, DuckDbAction, type DuckDbActionType, type DuckDbBatchOptions, type BatchResponse as DuckDbBatchResponse, DuckDbDatabaseHandle, type DuckDbExecuteOptions, type ExecuteResponse as DuckDbExecuteResponse, type DuckDbOptions, type DuckDbQueryOptions, type QueryResponse as DuckDbQueryResponse, DuckDbService, type DuckDbServiceConfig, type DuckDbStatement, type DuckDbValue, FetchFunction, GenericKVResponseSchema, type GenericKVResponseType, GenericResultSchema, type IDataVaultService, type IDuckDbDatabaseHandle, type IDuckDbService, IKVService, IService, IServiceContext, InvokeFunction, KVListResponseSchema, type KVListResponseType, KVListResultSchema, type KVListResultType, KVResponseHeadersSchema, type KVResponseHeadersType, type QuotaConfig, type QuotaStatus, Result, RetryPolicy, RetryPolicySchema, type RetryPolicyType, type SchemaInfo, type ServiceConstructor, ServiceContext, type ServiceContextConfig, ServiceError, ServiceErrorEventSchema, type ServiceErrorEventType, ServiceErrorSchema, type ServiceErrorType, type ServiceRegistration, ServiceRequestEventSchema, type ServiceRequestEventType, ServiceResponseEventSchema, type ServiceResponseEventType, ServiceRetryEventSchema, type ServiceRetryEventType, ServiceSession, ServiceSessionSchema, type ServiceSessionType, StorageQuotaInfo, type TableInfo, TinyCloudQuota, type ValidationError, type VaultCrypto, type VaultEntry, type VaultError, type VaultGetOptions, type VaultGrantOptions, VaultHeaders, type VaultListOptions, VaultPublicSpaceKVActions, type VaultPutOptions, type ViewInfo, type WasmVaultFunctions, abortedError, authExpiredError, authRequiredError, authUnauthorizedError, createKVResponseSchema, createResultSchema, createVaultCrypto, errorResult, networkError, notFoundError, parseAuthError, permissionDeniedError, storageLimitReachedError, storageQuotaExceededError, timeoutError, validateKVListResponse, validateKVResponseHeaders, validateRetryPolicy, validateServiceError, validateServiceRequestEvent, validateServiceResponseEvent, validateServiceSession, wrapError };
+export { BaseService, type BaseServiceOptions, type ColumnInfo, type DataVaultConfig, DataVaultService, DuckDbAction, type DuckDbActionType, type DuckDbBatchOptions, type BatchResponse as DuckDbBatchResponse, DuckDbDatabaseHandle, type DuckDbExecuteOptions, type ExecuteResponse as DuckDbExecuteResponse, type DuckDbOptions, type DuckDbQueryOptions, type QueryResponse as DuckDbQueryResponse, DuckDbService, type DuckDbServiceConfig, type DuckDbStatement, type DuckDbValue, FetchFunction, GenericKVResponseSchema, type GenericKVResponseType, GenericResultSchema, type HookEvent, type HookServiceName, type HookStreamEvent, type HookSubscription, type HookWebhookListOptions, type HookWebhookRecord, type HookWebhookRegistration, type HookWebhookScope, type HookWebhookUnregisterOptions, HooksService, type HooksServiceConfig, type IDataVaultService, type IDuckDbDatabaseHandle, type IDuckDbService, type IHooksService, IKVService, IService, IServiceContext, InvokeAnyFunction, InvokeFunction, KVListResponseSchema, type KVListResponseType, KVListResultSchema, type KVListResultType, KVResponseHeadersSchema, type KVResponseHeadersType, type QuotaConfig, type QuotaStatus, Result, RetryPolicy, RetryPolicySchema, type RetryPolicyType, type SchemaInfo, type ServiceConstructor, ServiceContext, type ServiceContextConfig, ServiceError, ServiceErrorEventSchema, type ServiceErrorEventType, ServiceErrorSchema, type ServiceErrorType, type ServiceRegistration, ServiceRequestEventSchema, type ServiceRequestEventType, ServiceResponseEventSchema, type ServiceResponseEventType, ServiceRetryEventSchema, type ServiceRetryEventType, ServiceSession, ServiceSessionSchema, type ServiceSessionType, StorageQuotaInfo, type SubscribeOptions, type TableInfo, TinyCloudQuota, type ValidationError, type VaultCrypto, type VaultEntry, type VaultError, type VaultGetOptions, type VaultGrantOptions, VaultHeaders, type VaultListOptions, VaultPublicSpaceKVActions, type VaultPutOptions, type ViewInfo, type WasmVaultFunctions, abortedError, authExpiredError, authRequiredError, authUnauthorizedError, createKVResponseSchema, createResultSchema, createVaultCrypto, errorResult, networkError, notFoundError, parseAuthError, permissionDeniedError, storageLimitReachedError, storageQuotaExceededError, timeoutError, validateKVListResponse, validateKVResponseHeaders, validateRetryPolicy, validateServiceError, validateServiceRequestEvent, validateServiceResponseEvent, validateServiceSession, wrapError };