@amigo-ai/platform-sdk 0.33.0 → 0.37.0

package/dist/resources/functions.js

@@ -38,5 +38,86 @@ export class FunctionsResource extends WorkspaceScopedResource {
             params: { path: { workspace_id: this.workspaceId } },
         }));
     }
+    // ── V109 SQL-first surface ────────────────────────────────────────
+    // The methods below operate against ``platform.functions`` (the
+    // versioned, alias-pinned, typed-parameter table introduced in
+    // platform migration V109). The legacy methods above continue to
+    // wrap the JSONB-backed ``workspace.settings["functions"]`` shape;
+    // both surfaces co-exist so callers can migrate at their own pace.
+    /**
+     * Validate + register a new platform function version. Atomic:
+     * validation + INSERT + ``latest`` alias rebind happen in one
+     * transaction. Concurrent deploys race-fail on the UNIQUE
+     * constraint and return 409.
+     */
+    async deploy(body) {
+        return extractData(await this.client.POST('/v1/{workspace_id}/functions/deploy', {
+            params: { path: { workspace_id: this.workspaceId } },
+            body,
+        }));
+    }
+    /**
+     * List all immutable versions of a registered function, newest first.
+     */
+    async listVersions(functionName) {
+        return extractData(await this.client.GET('/v1/{workspace_id}/functions/{function_name}/versions', {
+            params: { path: { workspace_id: this.workspaceId, function_name: functionName } },
+        }));
+    }
+    /**
+     * Resolve ``(function_name, alias)`` to a specific version row.
+     * Default alias: ``latest``.
+     */
+    async getVersion(functionName, alias = 'latest') {
+        return extractData(await this.client.GET('/v1/{workspace_id}/functions/{function_name}/version', {
+            params: {
+                path: { workspace_id: this.workspaceId, function_name: functionName },
+                query: { alias },
+            },
+        }));
+    }
+    /**
+     * Execute a registered function. Bound parameters validated against
+     * the version's stored schema; ``ws_id`` auto-injected from request
+     * context. Returns the executor's shaped response (rows for
+     * ``returns=table``, scalar for ``returns=scalar``).
+     */
+    async invoke(functionName, body) {
+        return extractData(await this.client.POST('/v1/{workspace_id}/functions/{function_name}/invoke', {
+            params: { path: { workspace_id: this.workspaceId, function_name: functionName } },
+            body,
+        }));
+    }
+    /**
+     * Test invoke — same as ``invoke`` plus persists ``last_test_*``
+     * telemetry on the version row so the DC tool list can show
+     * health without re-running.
+     */
+    async testV2(functionName, body) {
+        return extractData(await this.client.POST('/v1/{workspace_id}/functions/{function_name}/v2/test', {
+            params: { path: { workspace_id: this.workspaceId, function_name: functionName } },
+            body,
+        }));
+    }
+    /**
+     * Rebind an alias (``latest`` / ``staging`` / ``production``) to a
+     * specific version. Verifies the version exists before rebinding.
+     */
+    async promote(functionName, body) {
+        return extractData(await this.client.POST('/v1/{workspace_id}/functions/{function_name}/promote', {
+            params: { path: { workspace_id: this.workspaceId, function_name: functionName } },
+            body,
+        }));
+    }
+    /**
+     * Rebind ``latest`` and ``production`` to a prior version. The
+     * "oops the new deploy was bad" path. ``staging`` stays untouched.
+     */
+    async rollback(functionName, body) {
+        return extractData(await this.client.POST('/v1/{workspace_id}/functions/{function_name}/rollback', {
+            params: { path: { workspace_id: this.workspaceId, function_name: functionName } },
+            body,
+        }));
+    }
 }
 //# sourceMappingURL=functions.js.map

package/dist/resources/functions.js.map

@@ -1 +1 @@
-{"version":3,"file":"functions.js","sourceRoot":"","sources":["../../src/resources/functions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAEhE,MAAM,OAAO,iBAAkB,SAAQ,uBAAuB;IAC5D,KAAK,CAAC,IAAI;QACR,OAAO,WAAW,CAChB,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,8BAA8B,EAAE;YACpD,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE;SACrD,CAAC,CACH,CAAA;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAoD;QAC/D,OAAO,WAAW,CAChB,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,8BAA8B,EAAE;YACrD,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE;YACpD,IAAI;SACL,CAAC,CACH,CAAA;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,YAAoB;QAC/B,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,8CAA8C,EAAE;YACvE,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,EAAE;SAClF,CAAC,CAAA;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,YAAoB,EAAE,IAAkD;QACjF,OAAO,WAAW,CAChB,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,mDAAmD,EAAE;YAC1E,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,EAAE;YACjF,IAAI;SACL,CAAC,CACH,CAAA;IACH,CAAC;IAED,KAAK,CAAC,UAAU;QACd,OAAO,WAAW,CAChB,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,sCAAsC,EAAE;YAC5D,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE;SACrD,CAAC,CACH,CAAA;IACH,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAA2C;QACrD,OAAO,WAAW,CAChB,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,oCAAoC,EAAE;YAC3D,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE;YACpD,IAAI;SACL,CAAC,CACH,CAAA;IACH,CAAC;IAED,KAAK,CAAC,IAAI;QACR,OAAO,WAAW,CAChB,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,mCAAmC,EAAE;YAC1D,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE;SACrD,CAAC,CACH,CAAA;IACH,CAAC;CACF"}
+{"version":3,"file":"functions.js","sourceRoot":"","sources":["../../src/resources/functions.ts"],"names":[],"mappings":"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"}