primitive-admin 1.1.0 → 1.2.0-alpha.1

package/dist/src/lib/api-client.d.ts

@@ -655,8 +655,6 @@ export declare class ApiClient {
         items: any[];
         nextCursor?: string;
         hasMore?: boolean;
-        /** @deprecated Alias of `nextCursor` (#1316). */
-        cursor?: string;
     }>;
     createInvitation(appId: string, data: {
         email: string;
@@ -685,8 +683,6 @@ export declare class ApiClient {
         cursor?: string;
     }): Promise<{
         items: any[];
-        /** @deprecated Read `items`; `grants` is a legacy alias of it (#1982). */
-        grants: any[];
         nextCursor?: string | null;
         hasMore?: boolean;
     }>;
@@ -968,8 +964,6 @@ export declare class ApiClient {
         items: any[];
         hasMore?: boolean;
         nextCursor?: string | null;
-        /** @deprecated Alias of `nextCursor` (#1316). */
-        cursor?: string | null;
     }>;
     /**
      * List the live connections the server believes exist for exactly one of a
@@ -1354,8 +1348,6 @@ export declare class ApiClient {
         items: any[];
         hasMore?: boolean;
         nextCursor?: string | null;
-        /** @deprecated Alias of `nextCursor` (#1316). */
-        cursor?: string | null;
         /** #1969 — opaque follow checkpoint; present on `follow=true` responses. */
         resumeAfter?: string;
         /**
@@ -1380,8 +1372,6 @@ export declare class ApiClient {
         items: any[];
         hasMore?: boolean;
         nextCursor?: string | null;
-        /** @deprecated Alias of `nextCursor` (#1316). */
-        cursor?: string | null;
         /** #2237 — index rows examined; filtered reads only, `undefined` if unknown. */
         scanned?: number;
     }>;
@@ -1490,12 +1480,8 @@ export declare class ApiClient {
         cursor?: string;
     }): Promise<{
         items: any[];
-        /** @deprecated Read `items`; `admins` is a legacy alias of it (#1982). */
-        admins: any[];
         hasMore?: boolean;
         nextCursor: string | null;
-        /** @deprecated Read `nextCursor`; `cursor` is a legacy alias of it (#1316, #1982). */
-        cursor: string | null;
     }>;
     searchAdminByEmail(email: string): Promise<any>;
     getAdminApps(email: string): Promise<any>;
@@ -1664,51 +1650,14 @@ export declare class ApiClient {
     createDatabase(appId: string, data: {
         title: string;
         databaseType?: string;
-        metadata?: Record<string, any> | string;
         initialMetadata?: Record<string, Record<string, unknown>>;
     }): Promise<any>;
     getDatabase(appId: string, databaseId: string): Promise<any>;
     updateDatabase(appId: string, databaseId: string, data: Record<string, any>): Promise<any>;
     deleteDatabase(appId: string, databaseId: string): Promise<void>;
-    /**
-     * Read a database's CEL context dict.
-     *
-     * The HTTP path stays `/metadata` because the wire field name is still
-     * `metadata`; only the client/CLI-facing helper names were reframed.
-     *
-     * @deprecated Use resource metadata categories instead (`primitive metadata
-     * get database <id> <category>`, #1420, #1815).
-     */
-    getDatabaseCelContext(appId: string, databaseId: string): Promise<any>;
-    /**
-     * Update a database's CEL context dict (merge with existing).
-     *
-     * @deprecated Use resource metadata categories instead (`primitive metadata
-     * set database <id> <category>`, #1420, #1815).
-     */
-    updateDatabaseCelContext(appId: string, databaseId: string, celContext: Record<string, any>): Promise<any>;
-    /**
-     * @deprecated Database CEL context is deprecated; use resource metadata
-     * categories instead (`primitive metadata get database <id> <category>`,
-     * #1420, #1815).
-     */
-    getDatabaseMetadata(appId: string, databaseId: string): Promise<any>;
-    /**
-     * @deprecated Database CEL context is deprecated; use resource metadata
-     * categories instead (`primitive metadata set database <id> <category>`,
-     * #1420, #1815).
-     */
-    updateDatabaseMetadata(appId: string, databaseId: string, metadata: Record<string, any>): Promise<any>;
     listDatabasePermissions(appId: string, databaseId: string): Promise<any[]>;
     addDatabaseManager(appId: string, databaseId: string, userId: string): Promise<any>;
     removeDatabaseManager(appId: string, databaseId: string, userId: string): Promise<any>;
-    /** @deprecated Use {@link addDatabaseManager} instead. */
-    grantDatabasePermission(appId: string, databaseId: string, data: {
-        userId: string;
-        permission: "manager";
-    }): Promise<any>;
-    /** @deprecated Use {@link removeDatabaseManager} instead. */
-    revokeDatabasePermission(appId: string, databaseId: string, userId: string): Promise<any>;
     listDatabaseModels(appId: string, databaseId: string): Promise<any>;
     describeDatabaseModel(appId: string, databaseId: string, modelName: string): Promise<any>;
     /**
@@ -1924,14 +1873,13 @@ export declare class ApiClient {
         items: any[];
         nextCursor?: string;
         hasMore?: boolean;
-        /** @deprecated Alias of `nextCursor` (#1316). */
-        cursor?: string;
     }>;
     createGroup(appId: string, data: {
         groupType: string;
         groupId?: string;
         name: string;
         description?: string;
+        initialMetadata?: Record<string, Record<string, unknown>>;
     }): Promise<any>;
     getGroup(appId: string, groupType: string, groupId: string): Promise<any>;
     updateGroup(appId: string, groupType: string, groupId: string, data: {
@@ -1955,8 +1903,6 @@ export declare class ApiClient {
         items: any[];
         nextCursor?: string;
         hasMore?: boolean;
-        /** @deprecated Alias of `nextCursor` (#1316). */
-        cursor?: string;
     }>;
     addGroupMember(appId: string, groupType: string, groupId: string, data: {
         userId: string;
@@ -1991,12 +1937,10 @@ export declare class ApiClient {
         name: string;
         description?: string;
         /**
-         * Which rule set governs the collection, and which context it belongs
-         * to. Both are immutable after creation, so a migration has to send them
-         * with the create or never (#3643).
+         * Which rule set governs the collection. Immutable after creation, so a
+         * migration has to send it with the create or never (#3643).
          */
         collectionType?: string;
-        contextId?: string;
         initialMetadata?: Record<string, Record<string, unknown>>;
         /**
          * The app user to create the collection FOR (#3641). Honored only for
@@ -2200,9 +2144,6 @@ export declare class ApiClient {
      * through the caller's document permission (reader+) or the app-admin arm.
      * Returns the unified `{ items, hasMore, nextCursor? }` envelope. The cursor
      * is an opaque token — feed `nextCursor` back as `cursor` for the next page.
-     * The server also dual-emits a deprecated `cursor` alias (#1316); the
-     * normalizer drops it so CLI output is already on `nextCursor` when #1982
-     * removes it.
      */
     queryDocumentRecords(appId: string, documentId: string, modelName: string, queryOptions?: {
         filter?: Record<string, any>;
@@ -2449,9 +2390,6 @@ export declare class ApiClient {
      * of them". `paginateAll` carries the repeat-cursor and max-page guards, so
      * a server handing out a non-advancing cursor fails loudly instead of
      * looping forever.
-     *
-     * Tolerant of a pre-contract server, which answers with a bare
-     * `{ documents }` array and no cursor: that reads as a single page.
      */
     listAdminDocuments(appId: string, userId: string): Promise<any[]>;
     /**
@@ -2461,9 +2399,6 @@ export declare class ApiClient {
      * `--limit`/`--cursor` asked for, with the server's own page boundary
      * beside it. `documents export-all`, which really does mean every document,
      * keeps the walking `listAdminDocuments()` above.
-     *
-     * Tolerant of a pre-contract server, which answers with a bare
-     * `{ documents }` array and no cursor: that reads as a single page.
      */
     listAdminDocumentsPage(appId: string, userId: string, options?: {
         limit?: number;
@@ -2533,8 +2468,6 @@ export declare class ApiClient {
         items: any[];
         nextCursor?: string;
         hasMore?: boolean;
-        /** @deprecated Alias of `nextCursor` (#1316). */
-        cursor?: string;
     }>;
     uploadBucketBlob(appId: string, bucketIdOrKey: string, data: Buffer, meta: {
         filename: string;

package/dist/src/lib/api-client.js

@@ -412,13 +412,10 @@ export class ApiClient {
             qs.set("cursor", params.cursor);
         const q = qs.toString();
         const resp = await this.get(`/admin/api/admins/me/apps${q ? `?${q}` : ""}`);
-        // The server now emits `items` with `apps` as a deprecation-window alias
-        // (#1316). Read `items` first so listings keep working once the alias is
-        // removed; fall back to the legacy `apps` key meanwhile.
         return {
-            items: resp?.items ?? (Array.isArray(resp?.apps) ? resp.apps : []),
+            items: resp?.items ?? [],
             hasMore: resp?.hasMore,
-            nextCursor: resp?.nextCursor ?? resp?.cursor ?? null,
+            nextCursor: resp?.nextCursor ?? null,
         };
     }
     /**
@@ -455,15 +452,13 @@ export class ApiClient {
             if (cursor)
                 qs.set("cursor", cursor);
             const resp = await this.get(`/admin/api/apps?${qs.toString()}`);
-            // `items` first, with the `apps` alias (#1316) as the fallback,
-            // exactly as `listApps()` reads its own envelope.
-            const rows = resp.items ?? (Array.isArray(resp.apps) ? resp.apps : []);
+            const rows = resp.items ?? [];
             return {
                 items: rows.map((row) => ({
                     appId: String(row.appId ?? row.id ?? ""),
                     name: String(row.name ?? ""),
                 })),
-                nextCursor: resp.nextCursor ?? resp.cursor,
+                nextCursor: resp.nextCursor,
             };
         });
         return drainAppsUntilConverged(drainOnce);
@@ -596,14 +591,11 @@ export class ApiClient {
     // ============================================
     async listInvitations(appId, params) {
         const result = await this.get(`/app/${appId}/api/invitations`, params);
-        // #1316: prefer `nextCursor`; fall back to the deprecated `cursor` alias
-        // so the CLI keeps paginating against pre-#1316 servers.
-        const nextCursor = result?.nextCursor ?? result?.cursor;
+        const nextCursor = result?.nextCursor;
         return {
             items: result?.items ?? [],
             nextCursor,
             hasMore: result?.hasMore ?? nextCursor != null,
-            cursor: nextCursor,
         };
     }
     async createInvitation(appId, data) {
@@ -633,12 +625,9 @@ export class ApiClient {
     // ============================================
     async listDeferredGrants(appId, params) {
         const result = await this.get(`/app/${appId}/api/deferred-grants`, params);
-        // `items` is the key every list envelope is built from (#3646, #1982);
-        // `grants` is the deprecated legacy name, read only as a fallback.
-        const items = result?.items ?? result?.grants ?? [];
+        const items = result?.items ?? [];
         return {
             items,
-            grants: items,
             nextCursor: result?.nextCursor ?? null,
             hasMore: result?.hasMore,
         };
@@ -1020,13 +1009,11 @@ export class ApiClient {
     }
     async listWebhookEvents(appId, webhookId, params) {
         const result = await this.get(`/admin/api/apps/${appId}/webhooks/${webhookId}/events`, params);
-        // #1316: prefer `nextCursor`; fall back to the deprecated `cursor` alias.
-        const nextCursor = result?.nextCursor ?? result?.cursor ?? null;
+        const nextCursor = result?.nextCursor ?? null;
         return {
             items: result?.items ?? [],
             hasMore: result?.hasMore ?? !!nextCursor,
             nextCursor,
-            cursor: nextCursor,
         };
     }
     // ============================================
@@ -1576,13 +1563,11 @@ export class ApiClient {
     }
     async listWorkflowRuns(appId, workflowId, params) {
         const result = await this.get(`/admin/api/apps/${appId}/workflows/${workflowId}/runs`, params);
-        // #1316: prefer `nextCursor`; fall back to the deprecated `cursor` alias.
-        const nextCursor = result?.nextCursor ?? result?.cursor ?? null;
+        const nextCursor = result?.nextCursor ?? null;
         return {
             items: result?.items ?? [],
             hasMore: result?.hasMore,
             nextCursor,
-            cursor: nextCursor,
             resumeAfter: result?.resumeAfter,
             scanned: typeof result?.scanned === "number" ? result.scanned : undefined,
         };
@@ -1594,12 +1579,11 @@ export class ApiClient {
      */
     async listUserWorkflowRuns(appId, userId, params) {
         const result = await this.get(`/admin/api/apps/${appId}/users/${encodeURIComponent(userId)}/workflow-runs`, params);
-        const nextCursor = result?.nextCursor ?? result?.cursor ?? null;
+        const nextCursor = result?.nextCursor ?? null;
         return {
             items: result?.items ?? [],
             hasMore: result?.hasMore,
             nextCursor,
-            cursor: nextCursor,
             scanned: typeof result?.scanned === "number" ? result.scanned : undefined,
         };
     }
@@ -1707,17 +1691,12 @@ export class ApiClient {
     }
     async listAllAdmins(params) {
         const result = await this.get("/admin/api/admins", params);
-        // #1316: prefer `nextCursor`; fall back to the deprecated `cursor` alias.
-        const nextCursor = result?.nextCursor ?? result?.cursor ?? null;
-        const items = result?.items ?? result?.admins ?? [];
+        const nextCursor = result?.nextCursor ?? null;
+        const items = result?.items ?? [];
         return {
-            // `items` is the key every list envelope is built from (#3646, #1982);
-            // `admins` is the deprecated legacy name, read only as a fallback.
             items,
-            admins: items,
             hasMore: result?.hasMore,
             nextCursor,
-            cursor: nextCursor,
         };
     }
     async searchAdminByEmail(email) {
@@ -1911,43 +1890,6 @@ export class ApiClient {
     async deleteDatabase(appId, databaseId) {
         return this.delete(`/app/${appId}/api/databases/${databaseId}`);
     }
-    /**
-     * Read a database's CEL context dict.
-     *
-     * The HTTP path stays `/metadata` because the wire field name is still
-     * `metadata`; only the client/CLI-facing helper names were reframed.
-     *
-     * @deprecated Use resource metadata categories instead (`primitive metadata
-     * get database <id> <category>`, #1420, #1815).
-     */
-    async getDatabaseCelContext(appId, databaseId) {
-        return this.get(`/app/${appId}/api/databases/${databaseId}/metadata`);
-    }
-    /**
-     * Update a database's CEL context dict (merge with existing).
-     *
-     * @deprecated Use resource metadata categories instead (`primitive metadata
-     * set database <id> <category>`, #1420, #1815).
-     */
-    async updateDatabaseCelContext(appId, databaseId, celContext) {
-        return this.patch(`/app/${appId}/api/databases/${databaseId}/metadata`, celContext);
-    }
-    /**
-     * @deprecated Database CEL context is deprecated; use resource metadata
-     * categories instead (`primitive metadata get database <id> <category>`,
-     * #1420, #1815).
-     */
-    async getDatabaseMetadata(appId, databaseId) {
-        return this.getDatabaseCelContext(appId, databaseId);
-    }
-    /**
-     * @deprecated Database CEL context is deprecated; use resource metadata
-     * categories instead (`primitive metadata set database <id> <category>`,
-     * #1420, #1815).
-     */
-    async updateDatabaseMetadata(appId, databaseId, metadata) {
-        return this.updateDatabaseCelContext(appId, databaseId, metadata);
-    }
     // ============================================
     // DATABASE PERMISSIONS
     // ============================================
@@ -1963,14 +1905,6 @@ export class ApiClient {
     async removeDatabaseManager(appId, databaseId, userId) {
         return this.delete(`/app/${appId}/api/databases/${databaseId}/permissions/${userId}`);
     }
-    /** @deprecated Use {@link addDatabaseManager} instead. */
-    async grantDatabasePermission(appId, databaseId, data) {
-        return this.addDatabaseManager(appId, databaseId, data.userId);
-    }
-    /** @deprecated Use {@link removeDatabaseManager} instead. */
-    async revokeDatabasePermission(appId, databaseId, userId) {
-        return this.delete(`/app/${appId}/api/databases/${databaseId}/permissions/${userId}`);
-    }
     // ============================================
     // DATABASE RECORDS & SCHEMA
     // ============================================
@@ -2272,14 +2206,11 @@ export class ApiClient {
     // ============================================
     async listGroups(appId, params) {
         const result = await this.get(`/app/${appId}/api/groups`, params);
-        // #1316: prefer `nextCursor`; fall back to the deprecated `cursor` alias
-        // so the CLI keeps paginating against pre-#1316 servers.
-        const nextCursor = result?.nextCursor ?? result?.cursor;
+        const nextCursor = result?.nextCursor;
         return {
             items: result?.items ?? [],
             nextCursor,
             hasMore: result?.hasMore ?? nextCursor != null,
-            cursor: nextCursor,
         };
     }
     async createGroup(appId, data) {
@@ -2311,14 +2242,11 @@ export class ApiClient {
             ...(options?.limit !== undefined ? { limit: options.limit } : {}),
             ...(options?.cursor ? { cursor: options.cursor } : {}),
         });
-        // #1316: prefer `nextCursor`; fall back to the deprecated `cursor` alias
-        // so the CLI keeps paginating against pre-#1316 servers.
-        const nextCursor = result?.nextCursor ?? result?.cursor;
+        const nextCursor = result?.nextCursor;
         return {
             items: result?.items ?? [],
             nextCursor,
             hasMore: result?.hasMore ?? nextCursor != null,
-            cursor: nextCursor,
         };
     }
     async addGroupMember(appId, groupType, groupId, data) {
@@ -2365,7 +2293,7 @@ export class ApiClient {
         return {
             items: result?.items ?? [],
             hasMore: result?.hasMore,
-            nextCursor: result?.nextCursor ?? result?.cursor ?? null,
+            nextCursor: result?.nextCursor ?? null,
         };
     }
     async listAllCollections(appId, params) {
@@ -2379,7 +2307,7 @@ export class ApiClient {
         return {
             items: result?.items ?? [],
             hasMore: result?.hasMore,
-            nextCursor: result?.nextCursor ?? result?.cursor ?? null,
+            nextCursor: result?.nextCursor ?? null,
         };
     }
     async createCollection(appId, data) {
@@ -2408,7 +2336,7 @@ export class ApiClient {
         return {
             items: result?.items ?? [],
             hasMore: result?.hasMore,
-            nextCursor: result?.nextCursor ?? result?.cursor ?? null,
+            nextCursor: result?.nextCursor ?? null,
         };
     }
     async addCollectionDocument(appId, collectionId, data) {
@@ -2427,7 +2355,7 @@ export class ApiClient {
         const result = await this.get(`/app/${appId}/api/documents/${documentId}/collections${q ? `?${q}` : ""}`);
         return {
             items: result?.items ?? [],
-            nextCursor: result?.nextCursor ?? result?.cursor ?? null,
+            nextCursor: result?.nextCursor ?? null,
         };
     }
     // ============================================
@@ -2675,9 +2603,6 @@ export class ApiClient {
      * through the caller's document permission (reader+) or the app-admin arm.
      * Returns the unified `{ items, hasMore, nextCursor? }` envelope. The cursor
      * is an opaque token — feed `nextCursor` back as `cursor` for the next page.
-     * The server also dual-emits a deprecated `cursor` alias (#1316); the
-     * normalizer drops it so CLI output is already on `nextCursor` when #1982
-     * removes it.
      */
     async queryDocumentRecords(appId, documentId, modelName, queryOptions) {
         const query = {};
@@ -3002,9 +2927,6 @@ export class ApiClient {
      * of them". `paginateAll` carries the repeat-cursor and max-page guards, so
      * a server handing out a non-advancing cursor fails loudly instead of
      * looping forever.
-     *
-     * Tolerant of a pre-contract server, which answers with a bare
-     * `{ documents }` array and no cursor: that reads as a single page.
      */
     async listAdminDocuments(appId, userId) {
         return paginateAll(async (cursor) => {
@@ -3022,9 +2944,6 @@ export class ApiClient {
      * `--limit`/`--cursor` asked for, with the server's own page boundary
      * beside it. `documents export-all`, which really does mean every document,
      * keeps the walking `listAdminDocuments()` above.
-     *
-     * Tolerant of a pre-contract server, which answers with a bare
-     * `{ documents }` array and no cursor: that reads as a single page.
      */
     async listAdminDocumentsPage(appId, userId, options = {}) {
         const params = new URLSearchParams({ userId });
@@ -3034,11 +2953,9 @@ export class ApiClient {
             params.set("cursor", options.cursor);
         const result = await this.get(`/admin/api/apps/${appId}/documents?${params.toString()}`);
         return {
-            items: result?.items ?? result?.documents ?? [],
+            items: result?.items ?? [],
             hasMore: result?.hasMore,
-            // #1316: prefer `nextCursor`; the deprecated `cursor` alias keeps a
-            // shipped CLI paginating against a server that still dual-emits.
-            nextCursor: result?.nextCursor ?? result?.cursor ?? null,
+            nextCursor: result?.nextCursor ?? null,
         };
     }
     /**
@@ -3115,14 +3032,11 @@ export class ApiClient {
     }
     async listBucketBlobs(appId, bucketIdOrKey, params) {
         const result = await this.get(`/app/${appId}/api/blob-buckets/${encodeURIComponent(bucketIdOrKey)}/blobs`, params);
-        // #1316: prefer `nextCursor`; fall back to the deprecated `cursor` alias
-        // so the CLI keeps paginating against pre-#1316 servers.
-        const nextCursor = result?.nextCursor ?? result?.cursor;
+        const nextCursor = result?.nextCursor;
         return {
             items: result?.items ?? [],
             nextCursor,
             hasMore: result?.hasMore ?? nextCursor != null,
-            cursor: nextCursor,
         };
     }
     async uploadBucketBlob(appId, bucketIdOrKey, data, meta) {