primitive-admin 1.1.0-alpha.82 → 1.1.0-alpha.83

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

@@ -849,14 +849,41 @@ export declare class ApiClient {
     invokeFunction(appId: string, functionKey: string, body: Record<string, unknown>, options?: {
         bearer?: string;
         asSystem?: boolean;
+        /**
+         * Which runtime this call means — #3482. The ROUTE is the selector:
+         * `POST functions/{key}` runs the function inside the request and
+         * `POST functions/{key}/start` runs it as a task. The admin-only system
+         * door is ONE route for both, so `--as system` keeps naming its runtime
+         * in the body (F-3482-007); phase 7's rename may fold it.
+         */
+        runtime?: "request" | "task";
     }): Promise<{
         httpStatus: number;
         retryAfterSeconds: number | null;
         body: any;
     }>;
-    listFunctionConfigs(appId: string, functionId: string): Promise<{
+    /**
+     * A function's versions, newest first (#3462).
+     *
+     * Paging is opt-in on the server: with no `limit` and no `cursor` every
+     * version comes back, which is what this method did before paging existed and
+     * what an already-installed CLI still asks for. A caller that passes either
+     * gets the shared `{ items, hasMore, nextCursor }` page.
+     */
+    listFunctionConfigs(appId: string, functionId: string, options?: {
+        limit?: number;
+        cursor?: string;
+    }): Promise<{
         items: any[];
+        hasMore: boolean;
+        nextCursor?: string | null;
     }>;
+    /**
+     * Point the function at one of its OWN existing versions (#3462). Creates no
+     * version; the activated version's capabilities, limits and triggers apply
+     * from the next call.
+     */
+    activateFunctionConfig(appId: string, functionId: string, configId: string): Promise<any>;
     getFunctionConfig(appId: string, functionId: string, configId: string): Promise<any>;
     /**
      * The stored envelope: the authored TOML bytes, every source file and the
@@ -925,7 +952,11 @@ export declare class ApiClient {
         locks: any[];
     }>;
     getLockStatus(appId: string, key: string): Promise<any>;
-    acquireLock(appId: string, key: string, ttlMs: number): Promise<any>;
+    /**
+     * #3562 — `owner` is sent only when one was given, so a call that names none
+     * composes byte for byte the body it always did.
+     */
+    acquireLock(appId: string, key: string, ttlMs: number, owner?: string): Promise<any>;
     releaseLock(appId: string, key: string, handleId: string): Promise<any>;
     listCronTriggers(appId: string): Promise<{
         items: any[];
@@ -2057,6 +2088,48 @@ export declare class ApiClient {
         hasMore: boolean;
         nextCursor?: string;
     }>;
+    /**
+     * A large document's bulk-load sessions, newest first (#3434, criterion 9).
+     *
+     * Read-only, through the document read helper's app-admin arm — the same
+     * door the snapshot readers use. The action verb `documents ingest` is
+     * #3435's; these two are the operator's window onto what a session did.
+     */
+    listDocumentIngests(appId: string, documentId: string, options?: {
+        limit?: number;
+        cursor?: string;
+    }): Promise<{
+        items: any[];
+        hasMore: boolean;
+        nextCursor?: string;
+    }>;
+    /** One bulk-load session's status (#3434). */
+    getDocumentIngest(appId: string, documentId: string, sessionId: string): Promise<any>;
+    /** Open a bulk-load session on a large document (#3435, criterion 9). */
+    createDocumentIngest(appId: string, documentId: string): Promise<any>;
+    /**
+     * Upload one chunk of a bulk-load session's artifact (#3435).
+     *
+     * `multipart/form-data`: the eight descriptor fields as text parts and the
+     * gzipped bytes as one file part named `chunk`. No `Content-Type` is set on
+     * the request — fetch supplies the boundary, and a header written by hand
+     * would name one the body does not use.
+     */
+    uploadDocumentIngestChunk(appId: string, documentId: string, sessionId: string, chunk: {
+        model: string;
+        index: number;
+        rows: number;
+        bytes: number;
+        rawBytes: number;
+        sha256: string;
+        firstId: string;
+        lastId: string;
+        body: Buffer;
+    }): Promise<any>;
+    /** Freeze a session's manifest and hand it to the pipeline (#3435). */
+    commitDocumentIngest(appId: string, documentId: string, sessionId: string): Promise<any>;
+    /** Give a session up; allowed until the swap (#3435). */
+    abortDocumentIngest(appId: string, documentId: string, sessionId: string): Promise<any>;
     /** One snapshot build with its verification result (#3432). */
     getDocumentSnapshot(appId: string, documentId: string, buildId: string): Promise<any>;
     /**

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

@@ -871,9 +871,12 @@ export class ApiClient {
      */
     async invokeFunction(appId, functionKey, body, options) {
         const credentials = await this.ensureAuthenticated();
+        const base = `/app/${appId}/api/functions/${encodeURIComponent(functionKey)}`;
         const path = options?.asSystem
-            ? `/app/${appId}/api/functions/${encodeURIComponent(functionKey)}/invoke-as-system`
-            : `/app/${appId}/api/functions/${encodeURIComponent(functionKey)}`;
+            ? `${base}/invoke-as-system`
+            : options?.runtime === "task"
+                ? `${base}/start`
+                : base;
         const headers = {
             Authorization: `Bearer ${options?.bearer ?? credentials.accessToken}`,
             "Content-Type": "application/json",
@@ -907,9 +910,35 @@ export class ApiClient {
             body: parsed,
         };
     }
-    async listFunctionConfigs(appId, functionId) {
-        const result = await this.get(`/admin/api/apps/${appId}/functions/${functionId}/configs`);
-        return { items: result?.items ?? [] };
+    /**
+     * A function's versions, newest first (#3462).
+     *
+     * Paging is opt-in on the server: with no `limit` and no `cursor` every
+     * version comes back, which is what this method did before paging existed and
+     * what an already-installed CLI still asks for. A caller that passes either
+     * gets the shared `{ items, hasMore, nextCursor }` page.
+     */
+    async listFunctionConfigs(appId, functionId, options = {}) {
+        const query = new URLSearchParams();
+        if (options.limit !== undefined)
+            query.set("limit", String(options.limit));
+        if (options.cursor)
+            query.set("cursor", options.cursor);
+        const suffix = query.toString() ? `?${query.toString()}` : "";
+        const result = await this.get(`/admin/api/apps/${appId}/functions/${functionId}/configs${suffix}`);
+        return {
+            items: result?.items ?? [],
+            hasMore: result?.hasMore === true,
+            nextCursor: result?.nextCursor ?? null,
+        };
+    }
+    /**
+     * Point the function at one of its OWN existing versions (#3462). Creates no
+     * version; the activated version's capabilities, limits and triggers apply
+     * from the next call.
+     */
+    async activateFunctionConfig(appId, functionId, configId) {
+        return this.post(`/admin/api/apps/${appId}/functions/${functionId}/configs/${configId}/activate`, {});
     }
     async getFunctionConfig(appId, functionId, configId) {
         return this.get(`/admin/api/apps/${appId}/functions/${functionId}/configs/${configId}`);
@@ -1001,8 +1030,16 @@ export class ApiClient {
     async getLockStatus(appId, key) {
         return this.post(`/app/${appId}/api/locks/status`, { key });
     }
-    async acquireLock(appId, key, ttlMs) {
-        return this.post(`/app/${appId}/api/locks/acquire`, { key, ttlMs });
+    /**
+     * #3562 — `owner` is sent only when one was given, so a call that names none
+     * composes byte for byte the body it always did.
+     */
+    async acquireLock(appId, key, ttlMs, owner) {
+        return this.post(`/app/${appId}/api/locks/acquire`, {
+            key,
+            ttlMs,
+            ...(owner !== undefined ? { owner } : {}),
+        });
     }
     async releaseLock(appId, key, handleId) {
         return this.post(`/app/${appId}/api/locks/release`, {
@@ -2560,6 +2597,84 @@ export class ApiClient {
         const query = params.toString();
         return this.get(`/app/${appId}/api/documents/${documentId}/snapshots${query ? `?${query}` : ""}`);
     }
+    /**
+     * A large document's bulk-load sessions, newest first (#3434, criterion 9).
+     *
+     * Read-only, through the document read helper's app-admin arm — the same
+     * door the snapshot readers use. The action verb `documents ingest` is
+     * #3435's; these two are the operator's window onto what a session did.
+     */
+    async listDocumentIngests(appId, documentId, options = {}) {
+        const params = new URLSearchParams();
+        if (options.limit !== undefined)
+            params.set("limit", String(options.limit));
+        if (options.cursor)
+            params.set("cursor", options.cursor);
+        const query = params.toString();
+        return this.get(`/app/${appId}/api/documents/${documentId}/ingest${query ? `?${query}` : ""}`);
+    }
+    /** One bulk-load session's status (#3434). */
+    async getDocumentIngest(appId, documentId, sessionId) {
+        return this.get(`/app/${appId}/api/documents/${documentId}/ingest/${encodeURIComponent(sessionId)}`);
+    }
+    /** Open a bulk-load session on a large document (#3435, criterion 9). */
+    async createDocumentIngest(appId, documentId) {
+        return this.post(`/app/${appId}/api/documents/${documentId}/ingest`, {});
+    }
+    /**
+     * Upload one chunk of a bulk-load session's artifact (#3435).
+     *
+     * `multipart/form-data`: the eight descriptor fields as text parts and the
+     * gzipped bytes as one file part named `chunk`. No `Content-Type` is set on
+     * the request — fetch supplies the boundary, and a header written by hand
+     * would name one the body does not use.
+     */
+    async uploadDocumentIngestChunk(appId, documentId, sessionId, chunk) {
+        const credentials = await this.ensureAuthenticated();
+        const form = new FormData();
+        form.set("model", chunk.model);
+        form.set("index", String(chunk.index));
+        form.set("rows", String(chunk.rows));
+        form.set("bytes", String(chunk.bytes));
+        form.set("rawBytes", String(chunk.rawBytes));
+        form.set("sha256", chunk.sha256);
+        form.set("firstId", chunk.firstId);
+        form.set("lastId", chunk.lastId);
+        form.set("chunk", new Blob([chunk.body]), `${chunk.index}.ndjson.gz`);
+        const headers = {
+            Authorization: `Bearer ${credentials.accessToken}`,
+        };
+        if (credentials.globalAdminAppId) {
+            headers["X-Global-Admin-App-Id"] = credentials.globalAdminAppId;
+        }
+        const url = `${credentials.serverUrl}/app/${appId}/api/documents/${documentId}` +
+            `/ingest/${encodeURIComponent(sessionId)}/chunks`;
+        const response = await fetchWithTLS(url, {
+            method: "POST",
+            headers,
+            body: form,
+        });
+        const text = await response.text();
+        let result = {};
+        try {
+            result = text ? JSON.parse(text) : {};
+        }
+        catch {
+            result = { error: text };
+        }
+        if (!response.ok) {
+            throw new ApiError(result?.error || `Failed to upload chunk: ${response.statusText}`, response.status, result?.code, result?.details);
+        }
+        return result;
+    }
+    /** Freeze a session's manifest and hand it to the pipeline (#3435). */
+    async commitDocumentIngest(appId, documentId, sessionId) {
+        return this.post(`/app/${appId}/api/documents/${documentId}/ingest/${encodeURIComponent(sessionId)}/commit`, {});
+    }
+    /** Give a session up; allowed until the swap (#3435). */
+    async abortDocumentIngest(appId, documentId, sessionId) {
+        return this.post(`/app/${appId}/api/documents/${documentId}/ingest/${encodeURIComponent(sessionId)}/abort`, {});
+    }
     /** One snapshot build with its verification result (#3432). */
     async getDocumentSnapshot(appId, documentId, buildId) {
         return this.get(`/app/${appId}/api/documents/${documentId}/snapshots/${encodeURIComponent(buildId)}`);