@tailor-platform/function-types 0.9.0 → 0.10.1

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @tailor-platform/function-types
 
+## 0.10.1
+
+### Patch Changes
+
+- [#190](https://github.com/tailor-platform/function/pull/190) [`09dfbcc`](https://github.com/tailor-platform/function/commit/09dfbccaa0449077bf0e768bb85939918de2709f) Thanks [@toiroakr](https://github.com/toiroakr)! - Deprecate this package in favor of `@tailor-platform/sdk`, which now covers the same `tailor.*` / `tailordb.*` runtime surface. The README documents the deprecation and migration steps.
+
+## 0.10.0
+
+### Minor Changes
+
+- [#189](https://github.com/tailor-platform/function/pull/189) [`2e2f241`](https://github.com/tailor-platform/function/commit/2e2f241b0e9bb1480de7e376abbef3cd27aae30d) Thanks [@dragon3](https://github.com/dragon3)! - Add `tailor.aigateway.get(name)` types for resolving an AI Gateway URL in the caller's workspace.
+
+### Patch Changes
+
+- [#180](https://github.com/tailor-platform/function/pull/180) [`a36c24f`](https://github.com/tailor-platform/function/commit/a36c24faa835a350617b4f29c6e848894bcdc1e3) Thanks [@k1LoW](https://github.com/k1LoW)! - Remove non-existent `updatedAt` field from `tailor.idp.User`
+
 ## 0.9.0
 
 ### Minor Changes

package/README.md

@@ -1,18 +1,56 @@
 # @tailor-platform/function-types
 
-## Usage
+**Deprecated.** These types are now built into [`@tailor-platform/sdk`](https://www.npmjs.com/package/@tailor-platform/sdk), which exposes the same `tailor.*` / `tailordb.*` runtime surface plus typed wrappers you can import directly instead of relying on ambient globals. New projects should use `@tailor-platform/sdk` instead of this package; existing projects should migrate using the steps below.
+
+This package will no longer receive updates for new runtime APIs (e.g. it never picked up `tailor.aigateway.get()`, while `@tailor-platform/sdk` will keep gaining new runtime APIs).
+
+## Migrating to `@tailor-platform/sdk`
+
+1. Add `@tailor-platform/sdk` and remove this package:
+
+   ```sh
+   npm i -D @tailor-platform/sdk
+   npm uninstall @tailor-platform/function-types
+   ```
+
+   If your project already depends on `@tailor-platform/sdk` (e.g. for `tailor.config.ts`, resolvers, or workflows), you can skip the install step.
+
+2. Update `tsconfig.json` to load the runtime globals from the SDK instead:
+
+   ```diff
+     {
+       "compilerOptions": {
+   -      "types": ["@tailor-platform/function-types"]
+   +      "types": ["@tailor-platform/sdk/runtime/globals"]
+       }
+     }
+   ```
+
+3. No other code changes are required. The global `tailor.*` and `tailordb.*` identifiers keep the same names and shapes (including the legacy capitalized `Tailordb.Client`, which `@tailor-platform/sdk` also keeps around for compatibility with this package).
+
+### Prefer typed imports over ambient globals (optional)
+
+Instead of relying on the ambient `tailor` / `tailordb` globals, `@tailor-platform/sdk/runtime` exposes the same APIs as regular imports, which is easier to trace and doesn't require the `tsconfig.json` `types` change above:
+
+```typescript
+import { iconv, secretmanager, idp, workflow, context, authconnection, file } from "@tailor-platform/sdk/runtime";
+
+const secret = await secretmanager.getSecret("my-vault", "API_KEY");
+```
+
+### Known gap: `tailor.aigateway`
+
+`@tailor-platform/sdk` does not yet expose a runtime equivalent of `tailor.aigateway.get(name)`. If your code uses it, keep this package installed alongside `@tailor-platform/sdk` for that one namespace until the SDK adds support, or reach out to the SDK team if you need this migrated sooner.
+
+## Legacy usage (this package)
 
-Install package.
 ```sh
 npm i -D @tailor-platform/function-types
 ```
 
-Add types to `tsconfig.json`.
-```
+```json
 {
-  ...
   "compilerOptions": {
-    ...
     "types": ["@tailor-platform/function-types"]
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tailor-platform/function-types",
-  "version": "0.9.0",
+  "version": "0.10.1",
   "description": "TypeScript types for Tailor Platform Function service",
   "repository": {
     "type": "git",

package/tailor.d.ts

@@ -61,6 +61,27 @@ declare namespace tailor.authconnection {
   function getConnectionToken(connectionName: string): Promise<any>;
 }
 
+declare namespace tailor.aigateway {
+  /**
+   * AIGateway describes a resolved AI Gateway in the caller's workspace.
+   */
+  interface AIGateway {
+    /**
+     * Base URL of the AI Gateway, e.g.
+     * `https://my-aigateway-<workspace_hash>.ai.erp.dev`. Requests to this URL
+     * are automatically authenticated for the calling workspace.
+     */
+    url: string;
+  }
+
+  /**
+   * get resolves a named AI Gateway in the caller's own workspace and returns
+   * it. The gateway's existence is verified at call time, so resolving a name
+   * that does not exist rejects rather than failing later inside `fetch`.
+   */
+  function get(name: string): Promise<AIGateway>;
+}
+
 declare namespace tailor.iconv {
   /**
    * Convert string from one encoding to another
@@ -332,7 +353,6 @@ declare namespace tailor.idp {
     name: string;
     disabled: boolean;
     createdAt?: string;
-    updatedAt?: string;
   }
 
   /**