assembly-kit 0.0.1 → 0.0.4

package/CLAUDE.md

@@ -194,12 +194,12 @@ export const getAssemblyKit = cache((apiKey: string, workspaceId: string) =>
 
 ## Entry Points
 
-| Import path              | Key exports                                                                                               |
-| ------------------------ | --------------------------------------------------------------------------------------------------------- |
-| `assembly-kit`           | `createAssemblyKit`, `AssemblyKit`, errors, schemas, token utils                                          |
-| `assembly-kit/schemas`   | All Zod schemas and inferred types                                                                        |
-| `assembly-kit/client`    | `createAssemblyKit`, `AssemblyKit`, `AssemblyKitOptions`                                                  |
-| `assembly-kit/errors`    | All error classes                                                                                         |
-| `assembly-kit/token`     | `AssemblyToken`, `createToken`                                                                            |
-| `assembly-kit/logger`    | `createLogger`, `logger` (requires pino peer dep)                                                         |
-| `assembly-kit/bridge-ui` | `usePrimaryCta`, `useSecondaryCta`, `useActionsMenu` (requires react + @assembly-js/app-bridge peer deps) |
+| Import path              | Key exports                                                                                                          |
+| ------------------------ | -------------------------------------------------------------------------------------------------------------------- |
+| `assembly-kit`           | `createAssemblyKit`, `AssemblyKit`, errors, schemas, token utils                                                     |
+| `assembly-kit/schemas`   | All Zod schemas and inferred types                                                                                   |
+| `assembly-kit/client`    | `createAssemblyKit`, `AssemblyKit`, `AssemblyKitOptions`                                                             |
+| `assembly-kit/errors`    | All error classes                                                                                                    |
+| `assembly-kit/token`     | `AssemblyToken`, `createToken`                                                                                       |
+| `assembly-kit/logger`    | `createLogger`, `createPrettyLogger`, `logger` (requires pino peer dep; `createPrettyLogger` also needs pino-pretty) |
+| `assembly-kit/bridge-ui` | `usePrimaryCta`, `useSecondaryCta`, `useActionsMenu` (requires react + @assembly-js/app-bridge peer deps)            |

package/README.md

@@ -394,7 +394,7 @@ The payload is validated against `TokenPayloadSchema` before encryption. Throws
 
 ### Logger
 
-A request-scoped Pino logger is available from `assembly-kit/logger`. Requires `pino` and `pino-pretty` as peer dependencies.
+A request-scoped Pino logger is available from `assembly-kit/logger`. Requires `pino` as a peer dependency.
 
 ```typescript
 import { createLogger, logger } from "assembly-kit/logger";
@@ -409,7 +409,15 @@ import { logger } from "assembly-kit/logger";
 logger.info("starting up");
 ```
 
-The logger uses `pino-pretty` in non-production environments and plain JSON in production (`NODE_ENV=production`). The default log level respects the `LOG_LEVEL` environment variable.
+The logger emits plain JSON in all environments (no worker-thread transport, so it works in serverless runtimes like Vercel). `Error` objects are serialized with Pino's `err` serializer so message and stack survive — no more `{}` in Vercel logs. The default log level respects the `LOG_LEVEL` environment variable.
+
+For human-readable local output, use `createPrettyLogger`. It runs `pino-pretty` as a **synchronous stream** (no worker thread), so it is serverless-safe, but gate it to local runs to keep production plain JSON. Install `pino-pretty` (optional peer dependency) to use it:
+
+```typescript
+import { createLogger, createPrettyLogger } from "assembly-kit/logger";
+
+const log = process.env.NODE_ENV === "development" ? await createPrettyLogger() : createLogger();
+```
 
 ### App Bridge (React Hooks)
 
@@ -498,7 +506,7 @@ useActionsMenu([{ label: "Archive", onClick: () => archive() }], hasItems);
 | `assembly-kit/errors`    | All error classes                                                                           |
 | `assembly-kit/schemas`   | All Zod schemas and inferred types (no client dependency)                                   |
 | `assembly-kit/token`     | `AssemblyToken`, `createToken`, `ClientTokenPayload`, `InternalUserTokenPayload`            |
-| `assembly-kit/logger`    | `createLogger`, `logger`                                                                    |
+| `assembly-kit/logger`    | `createLogger`, `createPrettyLogger`, `logger`                                              |
 | `assembly-kit/bridge-ui` | `usePrimaryCta`, `useSecondaryCta`, `useActionsMenu`                                        |
 
 ## Development

package/dist/logger/index.d.mts

@@ -21,6 +21,25 @@ import { Logger, Logger as Logger$1, LoggerOptions, LoggerOptions as LoggerOptio
 declare const createLogger: (options?: LoggerOptions$1) => Logger$1;
 /** A default global logger instance for convenience. */
 declare const logger: Logger$1;
+/**
+ * Create a logger with human-readable colorized output for local development.
+ *
+ * Uses pino-pretty as a **synchronous stream** (`sync: true`) rather than the
+ * default worker-thread transport, so it is safe on serverless runtimes that
+ * forbid worker threads. Requires `pino-pretty` to be installed (optional peer
+ * dependency) — it is imported dynamically so plain-JSON users never bundle it.
+ *
+ * Gate it to local runs so production stays plain JSON:
+ *
+ * @example
+ * ```ts
+ * const log =
+ *   process.env.NODE_ENV === "development"
+ *     ? await createPrettyLogger()
+ *     : createLogger();
+ * ```
+ */
+declare const createPrettyLogger: (options?: LoggerOptions$1) => Promise<Logger$1>;
 //#endregion
-export { type Logger, type LoggerOptions, createLogger, logger };
+export { type Logger, type LoggerOptions, createLogger, createPrettyLogger, logger };
 //# sourceMappingURL=index.d.mts.map

package/dist/logger/index.mjs

@@ -3,9 +3,9 @@ import pino from "pino";
 //#region src/logger/index.ts
 const DEFAULT_OPTIONS = {
 	level: process.env.LOG_LEVEL ?? "info",
-	transport: process.env.NODE_ENV === "production" ? void 0 : {
-		options: { colorize: true },
-		target: "pino-pretty"
+	serializers: {
+		err: pino.stdSerializers.err,
+		error: pino.stdSerializers.err
 	}
 };
 const buildLogger = (options = {}) => pino({
@@ -39,7 +39,36 @@ const createLogger = (options = {}) => {
 };
 /** A default global logger instance for convenience. */
 const logger = buildLogger();
+/**
+* Create a logger with human-readable colorized output for local development.
+*
+* Uses pino-pretty as a **synchronous stream** (`sync: true`) rather than the
+* default worker-thread transport, so it is safe on serverless runtimes that
+* forbid worker threads. Requires `pino-pretty` to be installed (optional peer
+* dependency) — it is imported dynamically so plain-JSON users never bundle it.
+*
+* Gate it to local runs so production stays plain JSON:
+*
+* @example
+* ```ts
+* const log =
+*   process.env.NODE_ENV === "development"
+*     ? await createPrettyLogger()
+*     : createLogger();
+* ```
+*/
+const createPrettyLogger = async (options = {}) => {
+	const { default: pretty } = await import("pino-pretty");
+	const stream = pretty({
+		colorize: true,
+		sync: true
+	});
+	return pino({
+		...DEFAULT_OPTIONS,
+		...options
+	}, stream);
+};
 //#endregion
-export { createLogger, logger };
+export { createLogger, createPrettyLogger, logger };
 
 //# sourceMappingURL=index.mjs.map

package/dist/logger/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/logger/index.ts"],"sourcesContent":["import { AsyncLocalStorage } from \"node:async_hooks\";\n\nimport pino from \"pino\";\nimport type { Logger, LoggerOptions } from \"pino\";\n\nexport type { Logger, LoggerOptions } from \"pino\";\n\nconst DEFAULT_OPTIONS: LoggerOptions = {\n  level: process.env.LOG_LEVEL ?? \"info\",\n  transport:\n    process.env.NODE_ENV === \"production\"\n      ? undefined\n      : { options: { colorize: true }, target: \"pino-pretty\" },\n};\n\nconst buildLogger = (options: LoggerOptions = {}): Logger =>\n  pino({ ...DEFAULT_OPTIONS, ...options });\n\nconst store: AsyncLocalStorage<Logger> = new AsyncLocalStorage<Logger>();\n\n/**\n * Get or create a request-scoped logger via `AsyncLocalStorage`.\n * Returns the existing instance if one exists. Pass options to customize\n * on first call; subsequent calls in the same async context return the\n * same instance.\n *\n * @example\n * ```ts\n * const logger = createLogger({ level: \"debug\" });\n * logger.info(\"hello\");\n * logger.warn(\"careful\");\n * logger.error(\"oops\");\n *\n * // Later in the same async context:\n * const same = createLogger(); // returns the same instance\n * ```\n */\nexport const createLogger = (options: LoggerOptions = {}): Logger => {\n  const existing = store.getStore();\n  if (existing) {\n    return existing;\n  }\n  const instance = buildLogger(options);\n  store.enterWith(instance);\n  return instance;\n};\n\n/** A default global logger instance for convenience. */\nexport const logger: Logger = buildLogger();\n"],"mappings":";;;AAOA,MAAM,kBAAiC;CACrC,OAAO,QAAQ,IAAI,aAAa;CAChC,WACE,QAAQ,IAAI,aAAa,eACrB,KAAA,IACA;EAAE,SAAS,EAAE,UAAU,MAAM;EAAE,QAAQ;EAAe;CAC7D;AAED,MAAM,eAAe,UAAyB,EAAE,KAC9C,KAAK;CAAE,GAAG;CAAiB,GAAG;CAAS,CAAC;AAE1C,MAAM,QAAmC,IAAI,mBAA2B;;;;;;;;;;;;;;;;;;AAmBxE,MAAa,gBAAgB,UAAyB,EAAE,KAAa;CACnE,MAAM,WAAW,MAAM,UAAU;AACjC,KAAI,SACF,QAAO;CAET,MAAM,WAAW,YAAY,QAAQ;AACrC,OAAM,UAAU,SAAS;AACzB,QAAO;;;AAIT,MAAa,SAAiB,aAAa"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/logger/index.ts"],"sourcesContent":["import { AsyncLocalStorage } from \"node:async_hooks\";\n\nimport pino from \"pino\";\nimport type { Logger, LoggerOptions } from \"pino\";\n\nexport type { Logger, LoggerOptions } from \"pino\";\n\n// pino-pretty's default transport uses a worker thread that breaks in\n// serverless runtimes (Vercel, Cloudflare). Emit plain JSON everywhere.\n// The `err`/`error` serializers ensure Error objects log message + stack\n// instead of `{}` — the usual serverless footgun. For pretty local output\n// use `createPrettyLogger` below (sync stream, no worker thread).\nconst DEFAULT_OPTIONS: LoggerOptions = {\n  level: process.env.LOG_LEVEL ?? \"info\",\n  serializers: {\n    err: pino.stdSerializers.err,\n    error: pino.stdSerializers.err,\n  },\n};\n\nconst buildLogger = (options: LoggerOptions = {}): Logger =>\n  pino({ ...DEFAULT_OPTIONS, ...options });\n\nconst store: AsyncLocalStorage<Logger> = new AsyncLocalStorage<Logger>();\n\n/**\n * Get or create a request-scoped logger via `AsyncLocalStorage`.\n * Returns the existing instance if one exists. Pass options to customize\n * on first call; subsequent calls in the same async context return the\n * same instance.\n *\n * @example\n * ```ts\n * const logger = createLogger({ level: \"debug\" });\n * logger.info(\"hello\");\n * logger.warn(\"careful\");\n * logger.error(\"oops\");\n *\n * // Later in the same async context:\n * const same = createLogger(); // returns the same instance\n * ```\n */\nexport const createLogger = (options: LoggerOptions = {}): Logger => {\n  const existing = store.getStore();\n  if (existing) {\n    return existing;\n  }\n  const instance = buildLogger(options);\n  store.enterWith(instance);\n  return instance;\n};\n\n/** A default global logger instance for convenience. */\nexport const logger: Logger = buildLogger();\n\n/**\n * Create a logger with human-readable colorized output for local development.\n *\n * Uses pino-pretty as a **synchronous stream** (`sync: true`) rather than the\n * default worker-thread transport, so it is safe on serverless runtimes that\n * forbid worker threads. Requires `pino-pretty` to be installed (optional peer\n * dependency) — it is imported dynamically so plain-JSON users never bundle it.\n *\n * Gate it to local runs so production stays plain JSON:\n *\n * @example\n * ```ts\n * const log =\n *   process.env.NODE_ENV === \"development\"\n *     ? await createPrettyLogger()\n *     : createLogger();\n * ```\n */\nexport const createPrettyLogger = async (options: LoggerOptions = {}): Promise<Logger> => {\n  const { default: pretty } = await import(\"pino-pretty\");\n  const stream = pretty({ colorize: true, sync: true });\n  return pino({ ...DEFAULT_OPTIONS, ...options }, stream);\n};\n"],"mappings":";;;AAYA,MAAM,kBAAiC;CACrC,OAAO,QAAQ,IAAI,aAAa;CAChC,aAAa;EACX,KAAK,KAAK,eAAe;EACzB,OAAO,KAAK,eAAe;EAC5B;CACF;AAED,MAAM,eAAe,UAAyB,EAAE,KAC9C,KAAK;CAAE,GAAG;CAAiB,GAAG;CAAS,CAAC;AAE1C,MAAM,QAAmC,IAAI,mBAA2B;;;;;;;;;;;;;;;;;;AAmBxE,MAAa,gBAAgB,UAAyB,EAAE,KAAa;CACnE,MAAM,WAAW,MAAM,UAAU;AACjC,KAAI,SACF,QAAO;CAET,MAAM,WAAW,YAAY,QAAQ;AACrC,OAAM,UAAU,SAAS;AACzB,QAAO;;;AAIT,MAAa,SAAiB,aAAa;;;;;;;;;;;;;;;;;;;AAoB3C,MAAa,qBAAqB,OAAO,UAAyB,EAAE,KAAsB;CACxF,MAAM,EAAE,SAAS,WAAW,MAAM,OAAO;CACzC,MAAM,SAAS,OAAO;EAAE,UAAU;EAAM,MAAM;EAAM,CAAC;AACrD,QAAO,KAAK;EAAE,GAAG;EAAiB,GAAG;EAAS,EAAE,OAAO"}

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "assembly-kit",
-  "version": "0.0.1",
+  "version": "0.0.4",
   "description": "TypeScript SDK for the Assembly platform",
-  "homepage": "https://github.com/outsidestudio/assembly-kit#readme",
+  "homepage": "https://github.com/madebyoutside/assembly-kit#readme",
   "bugs": {
-    "url": "https://github.com/outsidestudio/assembly-kit/issues"
+    "url": "https://github.com/madebyoutside/assembly-kit/issues"
   },
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/outsidestudio/assembly-kit.git"
+    "url": "git+https://github.com/madebyoutside/assembly-kit.git"
   },
   "files": [
     "dist",
@@ -49,7 +49,7 @@
     "@typescript/native-preview": "7.0.0-dev.20260505.1",
     "bumpp": "^11.0.1",
     "pino": "^10.3.1",
-    "pino-pretty": "^13.1.3",
+    "pino-pretty": "^13.1.2",
     "react": "^19.2.5",
     "typescript": "^6.0.3",
     "vite-plus": "^0.1.20",
@@ -58,7 +58,7 @@
   "peerDependencies": {
     "@assembly-js/app-bridge": "^1.1.1",
     "pino": ">=9",
-    "pino-pretty": ">=10",
+    "pino-pretty": ">=11",
     "react": ">=18",
     "typescript": ">=5",
     "zod": ">=4"