@tailor-platform/sdk 1.60.1 → 1.60.2

package/docs/configuration.md

@@ -105,6 +105,7 @@ When using external resources:
 - The resource itself is not deployed by this project
 - The resource must be deployed and available before referencing it
 - You can combine external resources with locally-defined resources
+- TailorDB type names must remain unique across local and external TailorDB namespaces; `deploy` checks external TailorDB type names before applying changes
 - Destructive operations like `tailordb truncate` (and `seedPlugin`'s `seed:reset`) automatically exclude external resources to prevent accidental data loss in shared resources
 
 ### Built-in IdP
@@ -183,7 +184,7 @@ export default defineConfig({
 
 ### Environment Variables
 
-Define environment variables that can be accessed in resolvers, executors, and workflows:
+Use `env` in `defineConfig()` for non-secret values that application code needs at runtime, such as environment names, feature flags, and public service URLs. Values must be strings, numbers, or booleans.
 
 ```typescript
 export default defineConfig({
@@ -196,6 +197,32 @@ export default defineConfig({
 });
 ```
 
+`tailor.config.ts` runs locally when an SDK command loads the config. If values come from your shell or an env file, SDK commands can load them before config evaluation with the global [`--env-file`](./cli-reference.md#environment-file-loading) and `--env-file-if-exists` options:
+
+```typescript
+export default defineConfig({
+  name: "my-app",
+  env: {
+    foo: Number(process.env.FOO ?? "1"),
+    bar: process.env.BAR ?? "hello",
+    baz: (process.env.BAZ ?? "true") === "true",
+  },
+});
+```
+
+If the same config defines an auth before-login hook, make sure the config module can be evaluated without Node-only globals in the platform runtime. Avoid arbitrary `process.env` reads in that module; pass literal values, or values generated into a config module before deployment, and read them from the hook's `env` argument.
+
+When the SDK deploys application code or runs detected service code with `function test-run`, it passes the resolved values as the `env` argument. Do not read `process.env` from deployed resolvers, executors, workflow jobs, auth hooks, or migration scripts; Node-side environment variables are not available there. Put sensitive values in [Secret Manager](./services/secret.md) instead of `env`.
+
+| Code location             | Runtime access                                                                                                                            |
+| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
+| Resolver body             | `body: ({ env }) => ...`                                                                                                                  |
+| Executor callbacks        | `body: ({ env }) => ...`, `url: ({ env }) => String(env.bar)`, `variables: ({ env }) => ({ enabled: env.baz })`, or similar callback args |
+| Workflow job body         | `body: (input, { env }) => ...`                                                                                                           |
+| Auth before-login hook    | `handler: async ({ env }) => ...`                                                                                                         |
+| TailorDB migration script | `main(trx, { env }: MigrationContext)`                                                                                                    |
+| `function test-run`       | Same `env` argument shape as the detected resolver, executor, or workflow job                                                             |
+
 ```typescript
 // In resolvers
 body: ({ input, env }) => {
@@ -226,6 +253,12 @@ hooks: {
     invoker: "hook-invoker",
   },
 };
+
+// In TailorDB migration scripts
+export async function main(trx: Transaction, { env }: MigrationContext): Promise<void> {
+  if (!env.baz) return;
+  await trx.updateTable("User").set({ stage: env.bar }).execute();
+}
 ```
 
 ### Workflow Service

package/docs/services/executor.md

@@ -212,14 +212,14 @@ Execute JavaScript/TypeScript functions:
 createExecutor({
   operation: {
     kind: "function",
-    body: async ({ newRecord }) => {
-      console.log("New record created:", newRecord);
+    body: async ({ newRecord, env }) => {
+      console.log(`New record created in ${env.bar}:`, newRecord);
     },
   },
 });
 ```
 
-`function` and `jobFunction` `body` args include an `invoker` field: the principal running this function, overridden by `authInvoker` when set; `null` for anonymous calls. Other operation kinds (`graphql`, `webhook`, `workflow`) do not pass `invoker` into their callbacks.
+Executor callbacks receive the trigger args, including `env` from `defineConfig({ env })`. `function` and `jobFunction` `body` args also include an `invoker` field: the principal running this function, overridden by `authInvoker` when set; `null` for anonymous calls. Other operation kinds (`graphql`, `webhook`, `workflow`) receive `env` through their callback args but do not pass `invoker` into those callbacks.
 
 ### Job Function Operation
 

package/docs/services/tailordb.md

@@ -23,7 +23,7 @@ Define TailorDB Types in files matching glob patterns specified in `tailor.confi
 - **Multiple types per file**: You can define multiple TailorDB types in a single file
 - **Export method**: Use named exports (`export const`)
 - **Export both value and type**: Always export both the runtime value and TypeScript type
-- **Uniqueness**: Type names must be unique across all TailorDB files
+- **Uniqueness**: Type names must be unique across all TailorDB namespaces in the application
 
 ```typescript
 import { db } from "@tailor-platform/sdk";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tailor-platform/sdk",
-  "version": "1.60.1",
+  "version": "1.60.2",
   "description": "Tailor Platform SDK - The SDK to work with Tailor Platform",
   "license": "MIT",
   "repository": {