assembly-kit 0.0.3 → 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

@@ -409,7 +409,15 @@ import { logger } from "assembly-kit/logger";
 logger.info("starting up");
 ```
 
-The logger emits plain JSON in all environments (no worker-thread transport, so it works in serverless runtimes like Vercel). Pipe output through the `pino-pretty` CLI locally if you want human-readable logs. 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

@@ -1,7 +1,13 @@
 import { AsyncLocalStorage } from "node:async_hooks";
 import pino from "pino";
 //#region src/logger/index.ts
-const DEFAULT_OPTIONS = { level: process.env.LOG_LEVEL ?? "info" };
+const DEFAULT_OPTIONS = {
+	level: process.env.LOG_LEVEL ?? "info",
+	serializers: {
+		err: pino.stdSerializers.err,
+		error: pino.stdSerializers.err
+	}
+};
 const buildLogger = (options = {}) => pino({
 	...DEFAULT_OPTIONS,
 	...options
@@ -33,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\n// pino-pretty uses a worker-thread transport that breaks in serverless\n// runtimes (Vercel, Cloudflare). Emit plain JSON everywhere; pipe through\n// the pino-pretty CLI locally if you want pretty output.\nconst DEFAULT_OPTIONS: LoggerOptions = {\n  level: process.env.LOG_LEVEL ?? \"info\",\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":";;;AAUA,MAAM,kBAAiC,EACrC,OAAO,QAAQ,IAAI,aAAa,QACjC;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,6 +1,6 @@
 {
   "name": "assembly-kit",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "description": "TypeScript SDK for the Assembly platform",
   "homepage": "https://github.com/madebyoutside/assembly-kit#readme",
   "bugs": {
@@ -49,6 +49,7 @@
     "@typescript/native-preview": "7.0.0-dev.20260505.1",
     "bumpp": "^11.0.1",
     "pino": "^10.3.1",
+    "pino-pretty": "^13.1.2",
     "react": "^19.2.5",
     "typescript": "^6.0.3",
     "vite-plus": "^0.1.20",
@@ -57,6 +58,7 @@
   "peerDependencies": {
     "@assembly-js/app-bridge": "^1.1.1",
     "pino": ">=9",
+    "pino-pretty": ">=11",
     "react": ">=18",
     "typescript": ">=5",
     "zod": ">=4"
@@ -68,6 +70,9 @@
     "pino": {
       "optional": true
     },
+    "pino-pretty": {
+      "optional": true
+    },
     "react": {
       "optional": true
     },