@spacelr/sdk 0.4.0 → 0.5.0

package/dist/index.d.mts

@@ -1269,12 +1269,78 @@ declare class FunctionsModule {
     invoke(projectId: string, functionId: string, options?: FunctionInvokeOptions): Promise<FunctionInvokeResult>;
 }
 
+type ScheduleStatus = 'scheduled' | 'fired' | 'failed' | 'cancelled';
+interface Schedule {
+    id: string;
+    projectId: string;
+    functionId: string;
+    payload: Record<string, unknown>;
+    executeAt: string;
+    idempotencyKey: string | null;
+    status: ScheduleStatus;
+    bullJobId: string | null;
+    firedAt: string | null;
+    executionId: string | null;
+    attemptNumber: number;
+    maxAttempts: number;
+    lastError: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+interface ScheduleInvokeOptions {
+    /** 24-char hex function id to invoke when the schedule fires. */
+    functionId: string;
+    /** Arbitrary JSON payload surfaced to the function as `event.payload`. */
+    payload?: Record<string, unknown>;
+    /**
+     * When to fire. Accepts a `Date`, an ISO-8601 string, or epoch ms.
+     * Server-side applies a 5-second past-skew tolerance and rejects anything
+     * beyond `SCHEDULE_MAX_DELAY_DAYS` (default 90 days).
+     */
+    executeAt: Date | string | number;
+    /**
+     * Dedup key. Repeating the call with the same key in the same project for
+     * the same function returns the existing schedule unchanged.
+     */
+    idempotencyKey?: string;
+    /**
+     * Maximum retry attempts after a failed execution (0–10, default 3).
+     * Counts only retries — the initial fire is always attempted.
+     */
+    maxAttempts?: number;
+}
+interface ScheduleListOptions {
+    functionId?: string;
+    status?: ScheduleStatus;
+    limit?: number;
+    offset?: number;
+}
+declare class ScheduleModule {
+    private readonly http;
+    private readonly projectId;
+    constructor(http: HttpClient, projectId: string);
+    /**
+     * Schedule a one-shot function invocation. Returns the existing handle
+     * unchanged if `idempotencyKey` matches a prior invoke in this project
+     * for this function.
+     */
+    invoke(options: ScheduleInvokeOptions): Promise<Schedule>;
+    get(scheduleId: string): Promise<Schedule>;
+    list(options?: ScheduleListOptions): Promise<{
+        items: Schedule[];
+        total: number;
+    }>;
+    cancel(scheduleId: string): Promise<Schedule>;
+    private toIsoString;
+}
+
 interface SpacelrClient {
     readonly auth: AuthModule;
     readonly storage: StorageModule;
     readonly db: DatabaseModule;
     readonly notifications: NotificationsModule;
     readonly functions: FunctionsModule;
+    readonly schedule: ScheduleModule;
     /**
      * Store auth tokens externally (e.g. obtained via the auth-components
      * library that bypasses the SDK). Makes the tokens available to HTTP +
@@ -1326,4 +1392,4 @@ interface SpacelrClient {
 }
 declare function createClient(config: SpacelrClientConfig): SpacelrClient;
 
-export { type ApiResponse, type AuthLostReason, type AuthState, type AuthStateListener, type AuthorizationUrlParams, BrowserTokenStorage, CodeChallengeMethod, type ConnectionState, type CursorStorage, type DatabaseChangeEvent, type DownloadUrlResponse, type ExchangeCodeParams, type FileInfo, type FileListResponse, FileVisibility, type FunctionInvokeOptions, type FunctionInvokeResult, type GapReason, GrantType, type InitMultipartUploadParams, type InitMultipartUploadResponse, type JWK, type JWKSResponse, type ListFilesParams, type LoginParams, type LoginResponse, MemoryTokenStorage, type OpenIDConfiguration, type PKCEChallenge, type PartEtag, type PushSubscriptionInfo, type QuotaInfo, type RegisterParams, type RegisterResponse, type SearchOptions, type ShareFileParams, SharePermission, SpacelrAuthError, type SpacelrClient, type SpacelrClientConfig, SpacelrEmailVerificationRequiredError, SpacelrError, SpacelrNetworkError, SpacelrSearchFilterRequiredError, SpacelrTimeoutError, SpacelrTwoFactorRequiredError, type StoredTokens, type StreamGapInfo, type StreamSubscription, type SubscribeEventsHandlers, type SubscribeHandlers, type SubscribeWithSnapshotOptions, type TokenResponse, type TokenStorage, type TwoFactorResponse, type TwoFactorVerifyParams, type UnshareFileParams, type UploadFileParams, type UploadLargeFileParams, type UploadProgress, type UserInfo, type UserProfile, type VapidKeyResponse, createClient, generatePKCEChallenge, localStorageCursorStorage, memoryCursorStorage };
+export { type ApiResponse, type AuthLostReason, type AuthState, type AuthStateListener, type AuthorizationUrlParams, BrowserTokenStorage, CodeChallengeMethod, type ConnectionState, type CursorStorage, type DatabaseChangeEvent, type DownloadUrlResponse, type ExchangeCodeParams, type FileInfo, type FileListResponse, FileVisibility, type FunctionInvokeOptions, type FunctionInvokeResult, type GapReason, GrantType, type InitMultipartUploadParams, type InitMultipartUploadResponse, type JWK, type JWKSResponse, type ListFilesParams, type LoginParams, type LoginResponse, MemoryTokenStorage, type OpenIDConfiguration, type PKCEChallenge, type PartEtag, type PushSubscriptionInfo, type QuotaInfo, type RegisterParams, type RegisterResponse, type Schedule, type ScheduleInvokeOptions, type ScheduleListOptions, type ScheduleStatus, type SearchOptions, type ShareFileParams, SharePermission, SpacelrAuthError, type SpacelrClient, type SpacelrClientConfig, SpacelrEmailVerificationRequiredError, SpacelrError, SpacelrNetworkError, SpacelrSearchFilterRequiredError, SpacelrTimeoutError, SpacelrTwoFactorRequiredError, type StoredTokens, type StreamGapInfo, type StreamSubscription, type SubscribeEventsHandlers, type SubscribeHandlers, type SubscribeWithSnapshotOptions, type TokenResponse, type TokenStorage, type TwoFactorResponse, type TwoFactorVerifyParams, type UnshareFileParams, type UploadFileParams, type UploadLargeFileParams, type UploadProgress, type UserInfo, type UserProfile, type VapidKeyResponse, createClient, generatePKCEChallenge, localStorageCursorStorage, memoryCursorStorage };

package/dist/index.d.ts

@@ -1269,12 +1269,78 @@ declare class FunctionsModule {
     invoke(projectId: string, functionId: string, options?: FunctionInvokeOptions): Promise<FunctionInvokeResult>;
 }
 
+type ScheduleStatus = 'scheduled' | 'fired' | 'failed' | 'cancelled';
+interface Schedule {
+    id: string;
+    projectId: string;
+    functionId: string;
+    payload: Record<string, unknown>;
+    executeAt: string;
+    idempotencyKey: string | null;
+    status: ScheduleStatus;
+    bullJobId: string | null;
+    firedAt: string | null;
+    executionId: string | null;
+    attemptNumber: number;
+    maxAttempts: number;
+    lastError: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+interface ScheduleInvokeOptions {
+    /** 24-char hex function id to invoke when the schedule fires. */
+    functionId: string;
+    /** Arbitrary JSON payload surfaced to the function as `event.payload`. */
+    payload?: Record<string, unknown>;
+    /**
+     * When to fire. Accepts a `Date`, an ISO-8601 string, or epoch ms.
+     * Server-side applies a 5-second past-skew tolerance and rejects anything
+     * beyond `SCHEDULE_MAX_DELAY_DAYS` (default 90 days).
+     */
+    executeAt: Date | string | number;
+    /**
+     * Dedup key. Repeating the call with the same key in the same project for
+     * the same function returns the existing schedule unchanged.
+     */
+    idempotencyKey?: string;
+    /**
+     * Maximum retry attempts after a failed execution (0–10, default 3).
+     * Counts only retries — the initial fire is always attempted.
+     */
+    maxAttempts?: number;
+}
+interface ScheduleListOptions {
+    functionId?: string;
+    status?: ScheduleStatus;
+    limit?: number;
+    offset?: number;
+}
+declare class ScheduleModule {
+    private readonly http;
+    private readonly projectId;
+    constructor(http: HttpClient, projectId: string);
+    /**
+     * Schedule a one-shot function invocation. Returns the existing handle
+     * unchanged if `idempotencyKey` matches a prior invoke in this project
+     * for this function.
+     */
+    invoke(options: ScheduleInvokeOptions): Promise<Schedule>;
+    get(scheduleId: string): Promise<Schedule>;
+    list(options?: ScheduleListOptions): Promise<{
+        items: Schedule[];
+        total: number;
+    }>;
+    cancel(scheduleId: string): Promise<Schedule>;
+    private toIsoString;
+}
+
 interface SpacelrClient {
     readonly auth: AuthModule;
     readonly storage: StorageModule;
     readonly db: DatabaseModule;
     readonly notifications: NotificationsModule;
     readonly functions: FunctionsModule;
+    readonly schedule: ScheduleModule;
     /**
      * Store auth tokens externally (e.g. obtained via the auth-components
      * library that bypasses the SDK). Makes the tokens available to HTTP +
@@ -1326,4 +1392,4 @@ interface SpacelrClient {
 }
 declare function createClient(config: SpacelrClientConfig): SpacelrClient;
 
-export { type ApiResponse, type AuthLostReason, type AuthState, type AuthStateListener, type AuthorizationUrlParams, BrowserTokenStorage, CodeChallengeMethod, type ConnectionState, type CursorStorage, type DatabaseChangeEvent, type DownloadUrlResponse, type ExchangeCodeParams, type FileInfo, type FileListResponse, FileVisibility, type FunctionInvokeOptions, type FunctionInvokeResult, type GapReason, GrantType, type InitMultipartUploadParams, type InitMultipartUploadResponse, type JWK, type JWKSResponse, type ListFilesParams, type LoginParams, type LoginResponse, MemoryTokenStorage, type OpenIDConfiguration, type PKCEChallenge, type PartEtag, type PushSubscriptionInfo, type QuotaInfo, type RegisterParams, type RegisterResponse, type SearchOptions, type ShareFileParams, SharePermission, SpacelrAuthError, type SpacelrClient, type SpacelrClientConfig, SpacelrEmailVerificationRequiredError, SpacelrError, SpacelrNetworkError, SpacelrSearchFilterRequiredError, SpacelrTimeoutError, SpacelrTwoFactorRequiredError, type StoredTokens, type StreamGapInfo, type StreamSubscription, type SubscribeEventsHandlers, type SubscribeHandlers, type SubscribeWithSnapshotOptions, type TokenResponse, type TokenStorage, type TwoFactorResponse, type TwoFactorVerifyParams, type UnshareFileParams, type UploadFileParams, type UploadLargeFileParams, type UploadProgress, type UserInfo, type UserProfile, type VapidKeyResponse, createClient, generatePKCEChallenge, localStorageCursorStorage, memoryCursorStorage };
+export { type ApiResponse, type AuthLostReason, type AuthState, type AuthStateListener, type AuthorizationUrlParams, BrowserTokenStorage, CodeChallengeMethod, type ConnectionState, type CursorStorage, type DatabaseChangeEvent, type DownloadUrlResponse, type ExchangeCodeParams, type FileInfo, type FileListResponse, FileVisibility, type FunctionInvokeOptions, type FunctionInvokeResult, type GapReason, GrantType, type InitMultipartUploadParams, type InitMultipartUploadResponse, type JWK, type JWKSResponse, type ListFilesParams, type LoginParams, type LoginResponse, MemoryTokenStorage, type OpenIDConfiguration, type PKCEChallenge, type PartEtag, type PushSubscriptionInfo, type QuotaInfo, type RegisterParams, type RegisterResponse, type Schedule, type ScheduleInvokeOptions, type ScheduleListOptions, type ScheduleStatus, type SearchOptions, type ShareFileParams, SharePermission, SpacelrAuthError, type SpacelrClient, type SpacelrClientConfig, SpacelrEmailVerificationRequiredError, SpacelrError, SpacelrNetworkError, SpacelrSearchFilterRequiredError, SpacelrTimeoutError, SpacelrTwoFactorRequiredError, type StoredTokens, type StreamGapInfo, type StreamSubscription, type SubscribeEventsHandlers, type SubscribeHandlers, type SubscribeWithSnapshotOptions, type TokenResponse, type TokenStorage, type TwoFactorResponse, type TwoFactorVerifyParams, type UnshareFileParams, type UploadFileParams, type UploadLargeFileParams, type UploadProgress, type UserInfo, type UserProfile, type VapidKeyResponse, createClient, generatePKCEChallenge, localStorageCursorStorage, memoryCursorStorage };

package/dist/index.js

@@ -860,7 +860,7 @@ var RealtimeClient = class {
     if (!where || Object.keys(where).length === 0) {
       return base;
     }
-    const filterStr = Object.keys(where).sort().map((k) => `${k}=${String(where[k])}`).join("&");
+    const filterStr = Object.keys(where).sort().map((k) => `${k}=${JSON.stringify(where[k])}`).join("&");
     return `${base}?${filterStr}`;
   }
   async ensureConnected() {
@@ -1008,15 +1008,15 @@ var RealtimeClient = class {
     if (room === base) return true;
     if (!room.startsWith(`${base}?`)) return false;
     const where = this.roomWhereMap.get(room);
-    if (!where) return true;
+    if (!where) return false;
     if (!event.document) return false;
     for (const [key, value] of Object.entries(where)) {
       const docValue = event.document[key];
       if (Array.isArray(docValue)) {
-        if (!docValue.some((item) => String(item) === String(value))) {
+        if (!docValue.includes(value)) {
           return false;
         }
-      } else if (String(docValue) !== String(value)) {
+      } else if (docValue !== value) {
         return false;
       }
     }
@@ -2707,6 +2707,65 @@ var FunctionsModule = class {
   }
 };
 
+// libs/sdk/src/modules/schedule.module.ts
+var ScheduleModule = class {
+  constructor(http, projectId) {
+    this.http = http;
+    this.projectId = projectId;
+  }
+  /**
+   * Schedule a one-shot function invocation. Returns the existing handle
+   * unchanged if `idempotencyKey` matches a prior invoke in this project
+   * for this function.
+   */
+  async invoke(options) {
+    return this.http.request({
+      method: "POST",
+      path: `/schedules/${encodeURIComponent(this.projectId)}`,
+      body: {
+        functionId: options.functionId,
+        executeAt: this.toIsoString(options.executeAt),
+        ...options.payload !== void 0 ? { payload: options.payload } : {},
+        ...options.idempotencyKey !== void 0 ? { idempotencyKey: options.idempotencyKey } : {},
+        ...options.maxAttempts !== void 0 ? { maxAttempts: options.maxAttempts } : {}
+      },
+      authenticated: true
+    });
+  }
+  async get(scheduleId) {
+    return this.http.request({
+      method: "GET",
+      path: `/schedules/${encodeURIComponent(this.projectId)}/${encodeURIComponent(scheduleId)}`,
+      authenticated: true
+    });
+  }
+  async list(options = {}) {
+    return this.http.request({
+      method: "GET",
+      path: `/schedules/${encodeURIComponent(this.projectId)}`,
+      query: {
+        functionId: options.functionId,
+        status: options.status,
+        limit: options.limit,
+        offset: options.offset
+      },
+      authenticated: true
+    });
+  }
+  async cancel(scheduleId) {
+    return this.http.request({
+      method: "DELETE",
+      path: `/schedules/${encodeURIComponent(this.projectId)}/${encodeURIComponent(scheduleId)}`,
+      authenticated: true
+    });
+  }
+  toIsoString(input) {
+    if (input instanceof Date) return input.toISOString();
+    if (typeof input === "number") return new Date(input).toISOString();
+    return input;
+  }
+};
+
 // libs/sdk/src/client.ts
 function createClient(config) {
   const tokenStorage = config.tokenStorage ?? (typeof window !== "undefined" && typeof window.localStorage !== "undefined" ? new BrowserTokenStorage() : new MemoryTokenStorage());
@@ -2725,12 +2784,14 @@ function createClient(config) {
   const db = new DatabaseModule(httpClient, config.projectId, realtime);
   const notifications = new NotificationsModule(httpClient);
   const functions = new FunctionsModule(httpClient);
+  const schedule = new ScheduleModule(httpClient, config.projectId);
   return {
     auth,
     storage,
     db,
     notifications,
     functions,
+    schedule,
     setTokens(tokens) {
       return tokenManager.setTokens(tokens);
     },