@koderlabs/tasks-sdk-nextjs 0.1.0

package/dist/plugin.d.ts

@@ -0,0 +1,44 @@
+interface WithInstantTasksOptions {
+    /** Matches InitOptions.endpoint — where to POST source maps */
+    endpoint?: string;
+    /**
+     * Management secret key for source-map uploads.
+     * Defaults to process.env.INSTANTTASKS_SECRET_KEY.
+     */
+    secretKey?: string;
+    /**
+     * Skip source-map upload even in production. Useful during CI dry-runs.
+     * @default false
+     */
+    disableSourceMapUpload?: boolean;
+    /**
+     * Relative path to Next.js output directory.
+     * @default '.next'
+     */
+    distDir?: string;
+}
+type NextConfig = Record<string, any>;
+type NextConfigFn = (phase: string, args: Record<string, any>) => NextConfig | Promise<NextConfig>;
+/**
+ * `withInstantTasks(opts)(nextConfig)` — higher-order wrapper for next.config.js/ts.
+ *
+ * What it does:
+ *  1. Enables `productionBrowserSourceMaps: true` so Next.js emits browser .map files.
+ *  2. In production builds only, injects `InstantTasksSourceMapsPlugin` into the
+ *     Webpack config so source maps are uploaded after the client bundle is emitted.
+ *
+ * Turbopack v1 decision: Next.js 15 ships Turbopack as the **dev** bundler only;
+ * production builds continue to use Webpack. We hook into `webpack` here (v1).
+ * Turbopack plugin support is deferred to v1.1 once the `experimental.turbopack`
+ * plugin API stabilises.
+ *
+ * @example
+ * ```js
+ * // next.config.js
+ * const { withInstantTasks } = require('@koderlabs/tasks-sdk-nextjs/plugin');
+ * module.exports = withInstantTasks({ secretKey: process.env.IT_KEY })({});
+ * ```
+ */
+declare function withInstantTasks(opts?: WithInstantTasksOptions): (nextConfig: NextConfig | NextConfigFn) => NextConfig | NextConfigFn;
+
+export { type WithInstantTasksOptions, withInstantTasks };

package/dist/plugin.js

@@ -0,0 +1,7 @@
+import {
+  withInstantTasks
+} from "./chunk-2YRBUQGE.js";
+export {
+  withInstantTasks
+};
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/server.cjs

@@ -0,0 +1,56 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/server.ts
+var server_exports = {};
+__export(server_exports, {
+  getInstantTasks: () => getInstantTasks
+});
+module.exports = __toCommonJS(server_exports);
+var import_tasks_sdk = require("@koderlabs/tasks-sdk");
+function getInstantTasks(initOptions) {
+  const client = initOptions ? (0, import_tasks_sdk.init)(initOptions) : (0, import_tasks_sdk.getClient)();
+  return {
+    async notify(error, extra) {
+      if (!client) {
+        console.warn("[InstantTasks] notify() called but SDK not initialised.");
+        return;
+      }
+      try {
+        if (typeof client.errors?.notify === "function") {
+          await client.errors.notify(error, extra);
+        } else {
+          await client.send({
+            kind: "error",
+            message: error.message,
+            stack: error.stack,
+            ...extra
+          });
+        }
+      } catch (sendErr) {
+        console.error("[InstantTasks] Failed to notify error:", sendErr);
+      }
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getInstantTasks
+});
+//# sourceMappingURL=server.cjs.map

package/dist/server.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server.ts"],"sourcesContent":["/**\n * Server-side InstantTasks access for React Server Components and Route Handlers.\n *\n * v1 scope: manual `notify()` only — no automatic instrumentation.\n * Automatic error capturing for RSC render errors will be added in v1.1 once\n * the Next.js `onUncaughtException` instrumentation hook is stable.\n *\n * @example\n * ```ts\n * // app/api/route.ts\n * import { getInstantTasks } from '@koderlabs/tasks-sdk-nextjs/server';\n *\n * export async function GET() {\n *   try {\n *     // … handler logic …\n *   } catch (err) {\n *     const it = getInstantTasks();\n *     await it.notify(err as Error, { context: 'GET /api/route' });\n *     return new Response('Internal Server Error', { status: 500 });\n *   }\n * }\n * ```\n */\n\nimport { getClient, init } from '@koderlabs/tasks-sdk';\nimport type { InitOptions } from '@koderlabs/tasks-sdk';\n\nexport interface ServerInstantTasks {\n  /**\n   * Manually capture an error and send it to the InstantTasks API.\n   * No-ops when the SDK has not been initialised.\n   */\n  notify(error: Error, extra?: Record<string, unknown>): Promise<void>;\n}\n\n/**\n * Returns a server-side handle to the SDK.\n *\n * On the server there is no persistent singleton across requests (each Edge /\n * Node.js Worker context is isolated). Call `getInstantTasks()` at the top of\n * each server module or route handler.\n *\n * If `initOptions` is supplied and no client exists yet, init() is called\n * automatically. Otherwise the globally initialised client is reused (useful\n * when you call `init()` in `instrumentation.ts`).\n */\nexport function getInstantTasks(initOptions?: InitOptions): ServerInstantTasks {\n  const client = initOptions ? init(initOptions) : getClient();\n\n  return {\n    async notify(error: Error, extra?: Record<string, unknown>): Promise<void> {\n      if (!client) {\n        console.warn('[InstantTasks] notify() called but SDK not initialised.');\n        return;\n      }\n      try {\n        // Delegate to the errors sub-client when available (Phase B), otherwise\n        // fall back to raw send.\n        if (typeof (client as any).errors?.notify === 'function') {\n          await (client as any).errors.notify(error, extra);\n        } else {\n          await client.send({\n            kind: 'error',\n            message: error.message,\n            stack: error.stack,\n            ...extra,\n          } as any);\n        }\n      } catch (sendErr) {\n        console.error('[InstantTasks] Failed to notify error:', sendErr);\n      }\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAwBA,uBAAgC;AAsBzB,SAAS,gBAAgB,aAA+C;AAC7E,QAAM,SAAS,kBAAc,uBAAK,WAAW,QAAI,4BAAU;AAE3D,SAAO;AAAA,IACL,MAAM,OAAO,OAAc,OAAgD;AACzE,UAAI,CAAC,QAAQ;AACX,gBAAQ,KAAK,yDAAyD;AACtE;AAAA,MACF;AACA,UAAI;AAGF,YAAI,OAAQ,OAAe,QAAQ,WAAW,YAAY;AACxD,gBAAO,OAAe,OAAO,OAAO,OAAO,KAAK;AAAA,QAClD,OAAO;AACL,gBAAM,OAAO,KAAK;AAAA,YAChB,MAAM;AAAA,YACN,SAAS,MAAM;AAAA,YACf,OAAO,MAAM;AAAA,YACb,GAAG;AAAA,UACL,CAAQ;AAAA,QACV;AAAA,MACF,SAAS,SAAS;AAChB,gBAAQ,MAAM,0CAA0C,OAAO;AAAA,MACjE;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/server.d.cts

@@ -0,0 +1,47 @@
+import { InitOptions } from '@koderlabs/tasks-sdk';
+
+/**
+ * Server-side InstantTasks access for React Server Components and Route Handlers.
+ *
+ * v1 scope: manual `notify()` only — no automatic instrumentation.
+ * Automatic error capturing for RSC render errors will be added in v1.1 once
+ * the Next.js `onUncaughtException` instrumentation hook is stable.
+ *
+ * @example
+ * ```ts
+ * // app/api/route.ts
+ * import { getInstantTasks } from '@koderlabs/tasks-sdk-nextjs/server';
+ *
+ * export async function GET() {
+ *   try {
+ *     // … handler logic …
+ *   } catch (err) {
+ *     const it = getInstantTasks();
+ *     await it.notify(err as Error, { context: 'GET /api/route' });
+ *     return new Response('Internal Server Error', { status: 500 });
+ *   }
+ * }
+ * ```
+ */
+
+interface ServerInstantTasks {
+    /**
+     * Manually capture an error and send it to the InstantTasks API.
+     * No-ops when the SDK has not been initialised.
+     */
+    notify(error: Error, extra?: Record<string, unknown>): Promise<void>;
+}
+/**
+ * Returns a server-side handle to the SDK.
+ *
+ * On the server there is no persistent singleton across requests (each Edge /
+ * Node.js Worker context is isolated). Call `getInstantTasks()` at the top of
+ * each server module or route handler.
+ *
+ * If `initOptions` is supplied and no client exists yet, init() is called
+ * automatically. Otherwise the globally initialised client is reused (useful
+ * when you call `init()` in `instrumentation.ts`).
+ */
+declare function getInstantTasks(initOptions?: InitOptions): ServerInstantTasks;
+
+export { type ServerInstantTasks, getInstantTasks };

package/dist/server.d.ts

@@ -0,0 +1,47 @@
+import { InitOptions } from '@koderlabs/tasks-sdk';
+
+/**
+ * Server-side InstantTasks access for React Server Components and Route Handlers.
+ *
+ * v1 scope: manual `notify()` only — no automatic instrumentation.
+ * Automatic error capturing for RSC render errors will be added in v1.1 once
+ * the Next.js `onUncaughtException` instrumentation hook is stable.
+ *
+ * @example
+ * ```ts
+ * // app/api/route.ts
+ * import { getInstantTasks } from '@koderlabs/tasks-sdk-nextjs/server';
+ *
+ * export async function GET() {
+ *   try {
+ *     // … handler logic …
+ *   } catch (err) {
+ *     const it = getInstantTasks();
+ *     await it.notify(err as Error, { context: 'GET /api/route' });
+ *     return new Response('Internal Server Error', { status: 500 });
+ *   }
+ * }
+ * ```
+ */
+
+interface ServerInstantTasks {
+    /**
+     * Manually capture an error and send it to the InstantTasks API.
+     * No-ops when the SDK has not been initialised.
+     */
+    notify(error: Error, extra?: Record<string, unknown>): Promise<void>;
+}
+/**
+ * Returns a server-side handle to the SDK.
+ *
+ * On the server there is no persistent singleton across requests (each Edge /
+ * Node.js Worker context is isolated). Call `getInstantTasks()` at the top of
+ * each server module or route handler.
+ *
+ * If `initOptions` is supplied and no client exists yet, init() is called
+ * automatically. Otherwise the globally initialised client is reused (useful
+ * when you call `init()` in `instrumentation.ts`).
+ */
+declare function getInstantTasks(initOptions?: InitOptions): ServerInstantTasks;
+
+export { type ServerInstantTasks, getInstantTasks };

package/dist/server.js

@@ -0,0 +1,31 @@
+// src/server.ts
+import { getClient, init } from "@koderlabs/tasks-sdk";
+function getInstantTasks(initOptions) {
+  const client = initOptions ? init(initOptions) : getClient();
+  return {
+    async notify(error, extra) {
+      if (!client) {
+        console.warn("[InstantTasks] notify() called but SDK not initialised.");
+        return;
+      }
+      try {
+        if (typeof client.errors?.notify === "function") {
+          await client.errors.notify(error, extra);
+        } else {
+          await client.send({
+            kind: "error",
+            message: error.message,
+            stack: error.stack,
+            ...extra
+          });
+        }
+      } catch (sendErr) {
+        console.error("[InstantTasks] Failed to notify error:", sendErr);
+      }
+    }
+  };
+}
+export {
+  getInstantTasks
+};
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server.ts"],"sourcesContent":["/**\n * Server-side InstantTasks access for React Server Components and Route Handlers.\n *\n * v1 scope: manual `notify()` only — no automatic instrumentation.\n * Automatic error capturing for RSC render errors will be added in v1.1 once\n * the Next.js `onUncaughtException` instrumentation hook is stable.\n *\n * @example\n * ```ts\n * // app/api/route.ts\n * import { getInstantTasks } from '@koderlabs/tasks-sdk-nextjs/server';\n *\n * export async function GET() {\n *   try {\n *     // … handler logic …\n *   } catch (err) {\n *     const it = getInstantTasks();\n *     await it.notify(err as Error, { context: 'GET /api/route' });\n *     return new Response('Internal Server Error', { status: 500 });\n *   }\n * }\n * ```\n */\n\nimport { getClient, init } from '@koderlabs/tasks-sdk';\nimport type { InitOptions } from '@koderlabs/tasks-sdk';\n\nexport interface ServerInstantTasks {\n  /**\n   * Manually capture an error and send it to the InstantTasks API.\n   * No-ops when the SDK has not been initialised.\n   */\n  notify(error: Error, extra?: Record<string, unknown>): Promise<void>;\n}\n\n/**\n * Returns a server-side handle to the SDK.\n *\n * On the server there is no persistent singleton across requests (each Edge /\n * Node.js Worker context is isolated). Call `getInstantTasks()` at the top of\n * each server module or route handler.\n *\n * If `initOptions` is supplied and no client exists yet, init() is called\n * automatically. Otherwise the globally initialised client is reused (useful\n * when you call `init()` in `instrumentation.ts`).\n */\nexport function getInstantTasks(initOptions?: InitOptions): ServerInstantTasks {\n  const client = initOptions ? init(initOptions) : getClient();\n\n  return {\n    async notify(error: Error, extra?: Record<string, unknown>): Promise<void> {\n      if (!client) {\n        console.warn('[InstantTasks] notify() called but SDK not initialised.');\n        return;\n      }\n      try {\n        // Delegate to the errors sub-client when available (Phase B), otherwise\n        // fall back to raw send.\n        if (typeof (client as any).errors?.notify === 'function') {\n          await (client as any).errors.notify(error, extra);\n        } else {\n          await client.send({\n            kind: 'error',\n            message: error.message,\n            stack: error.stack,\n            ...extra,\n          } as any);\n        }\n      } catch (sendErr) {\n        console.error('[InstantTasks] Failed to notify error:', sendErr);\n      }\n    },\n  };\n}\n"],"mappings":";AAwBA,SAAS,WAAW,YAAY;AAsBzB,SAAS,gBAAgB,aAA+C;AAC7E,QAAM,SAAS,cAAc,KAAK,WAAW,IAAI,UAAU;AAE3D,SAAO;AAAA,IACL,MAAM,OAAO,OAAc,OAAgD;AACzE,UAAI,CAAC,QAAQ;AACX,gBAAQ,KAAK,yDAAyD;AACtE;AAAA,MACF;AACA,UAAI;AAGF,YAAI,OAAQ,OAAe,QAAQ,WAAW,YAAY;AACxD,gBAAO,OAAe,OAAO,OAAO,OAAO,KAAK;AAAA,QAClD,OAAO;AACL,gBAAM,OAAO,KAAK;AAAA,YAChB,MAAM;AAAA,YACN,SAAS,MAAM;AAAA,YACf,OAAO,MAAM;AAAA,YACb,GAAG;AAAA,UACL,CAAQ;AAAA,QACV;AAAA,MACF,SAAS,SAAS;AAChB,gBAAQ,MAAM,0CAA0C,OAAO;AAAA,MACjE;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/package.json

@@ -0,0 +1,85 @@
+{
+  "name": "@koderlabs/tasks-sdk-nextjs",
+  "version": "0.1.0",
+  "description": "Next.js plugin + source-map upload + client/server entries for the InstantTasks SDK.",
+  "keywords": [
+    "instanttasks",
+    "sdk",
+    "nextjs",
+    "source-maps"
+  ],
+  "homepage": "https://github.com/jawaidgadiwala/instant-tasks/tree/main/packages/sdk-nextjs#readme",
+  "bugs": {
+    "url": "https://github.com/jawaidgadiwala/instant-tasks/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jawaidgadiwala/instant-tasks.git",
+    "directory": "packages/sdk-nextjs"
+  },
+  "license": "UNLICENSED",
+  "author": {
+    "name": "Jawaid Gadiwala",
+    "email": "jawaidgadiwala@gmail.com",
+    "url": "https://koderlabs.com"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js",
+      "require": "./dist/client.cjs"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js",
+      "require": "./dist/server.cjs"
+    },
+    "./plugin": {
+      "types": "./dist/plugin.d.ts",
+      "import": "./dist/plugin.js",
+      "require": "./dist/plugin.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "dependencies": {
+    "@koderlabs/tasks-sdk": "0.1.0",
+    "@koderlabs/tasks-sdk-react": "0.1.0"
+  },
+  "peerDependencies": {
+    "next": "^14 || ^15",
+    "react": "^18 || ^19",
+    "react-dom": "^18 || ^19"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/react": "^18.3.0",
+    "tsup": "^8.3.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.1.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}