@koderlabs/tasks-sdk-vue 0.1.0

package/LICENSE

@@ -0,0 +1,179 @@
+PROPRIETARY SOFTWARE LICENSE — ALL RIGHTS RESERVED
+
+Copyright (c) 2026 KoderLabs. All rights reserved.
+Author: Jawaid Gadiwala <jawaidgadiwala@gmail.com>
+
+================================================================================
+1. NO LICENSE GRANTED BY DEFAULT
+================================================================================
+
+This software, including all source code, object code, documentation,
+configuration files, build artifacts, test fixtures, and any associated
+materials (collectively, the "Software"), is the proprietary and confidential
+property of KoderLabs.
+
+NO license, right, title, interest, or permission of any kind — express,
+implied, statutory, by estoppel, by exhaustion, by patent exhaustion, or by
+any other legal theory — is granted to any person or entity by:
+
+  (a) viewing the Software on any registry, repository, mirror, CDN,
+      cache, or other distribution channel (including but not limited to
+      npmjs.com, GitHub, GitLab, or any private registry);
+  (b) downloading, cloning, or otherwise obtaining a copy of the Software;
+  (c) the act of the Software being technically accessible due to a registry
+      requirement, mirror, or third-party distribution;
+  (d) any prior course of dealing, custom, or industry practice.
+
+The ability to access the Software does NOT imply any permission to use it.
+A separate, signed, written license agreement executed by an authorised
+representative of KoderLabs is the ONLY mechanism by which any rights may be
+granted.
+
+================================================================================
+2. PROHIBITED ACTIVITIES (NON-EXHAUSTIVE)
+================================================================================
+
+Without prior signed written permission from KoderLabs, the following are
+expressly PROHIBITED and constitute infringement, breach of contract, and
+unauthorised use:
+
+  (a) Copying the Software in whole or in part, in any medium;
+  (b) Modifying, adapting, translating, porting, or creating derivative works
+      of the Software;
+  (c) Distributing, republishing, mirroring, hosting, transmitting,
+      sublicensing, leasing, lending, renting, selling, offering for sale,
+      bartering, gifting, or otherwise transferring the Software or any
+      portion of it;
+  (d) Forking the Software's repository, whether on GitHub, GitLab, Bitbucket,
+      Codeberg, Sourcehut, or any other version-control hosting service;
+  (e) Reverse engineering, decompiling, disassembling, deobfuscating,
+      extracting source from compiled or minified artifacts, or attempting to
+      derive the source code, algorithms, or trade secrets;
+  (f) Removing, altering, or obscuring any copyright, trademark, license,
+      attribution, or proprietary notice;
+  (g) Using the Software, in whole or in part, to train, fine-tune,
+      evaluate, or benchmark any machine-learning model, embedding model, or
+      AI system;
+  (h) Using the Software to provide a hosted service, SaaS offering,
+      managed offering, or any form of public or commercial offering;
+  (i) Using the Software in any production, staging, development, evaluation,
+      or testing capacity, whether commercial or non-commercial;
+  (j) Bypassing, disabling, or attempting to circumvent any technical
+      protection measure (license check, telemetry, signature verification,
+      etc.) embedded in the Software;
+  (k) Combining or integrating the Software with any work licensed under a
+      copyleft licence (including but not limited to GPL, AGPL, LGPL, MPL,
+      EPL) in a manner that would purport to relicense the Software;
+  (l) Filing, prosecuting, or threatening patent litigation against KoderLabs
+      or its customers based on any feature, design, or behaviour of the
+      Software ("defensive termination" — any such action automatically and
+      immediately terminates any rights granted to the litigant elsewhere).
+
+================================================================================
+3. NO IMPLIED RIGHT TO INTERNAL USE
+================================================================================
+
+The Software is NOT licensed for internal evaluation, internal production,
+internal testing, or any other internal use unless and until a separate
+written commercial licence is executed. Possession of a copy of the Software,
+by whatever means, confers no right to execute, run, deploy, or use it.
+
+================================================================================
+4. NO PATENT, TRADEMARK, OR OTHER IP GRANT
+================================================================================
+
+No patent licence, trademark licence, trade-secret disclosure, design-right
+licence, or any other intellectual-property licence is granted under this
+notice. KoderLabs retains all such rights.
+
+================================================================================
+5. CONFIDENTIALITY
+================================================================================
+
+The Software contains trade secrets and confidential information of
+KoderLabs. Any party in possession of the Software shall (a) treat it as
+confidential, (b) take reasonable measures to prevent unauthorised access or
+disclosure, and (c) not disclose, publish, or make available the Software or
+any portion thereof to any third party.
+
+================================================================================
+6. AUTOMATIC TERMINATION
+================================================================================
+
+Any rights that may exist under a separate written agreement terminate
+AUTOMATICALLY AND IMMEDIATELY upon any breach of this notice, without notice
+and without judicial action. Upon termination, the breaching party shall
+immediately destroy all copies of the Software in its possession or control
+and certify destruction in writing to KoderLabs.
+
+================================================================================
+7. NO WARRANTY
+================================================================================
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, ACCURACY, RELIABILITY,
+TITLE, AVAILABILITY, OR THAT THE SOFTWARE WILL OPERATE UNINTERRUPTED OR
+ERROR-FREE.
+
+================================================================================
+8. NO LIABILITY
+================================================================================
+
+IN NO EVENT SHALL KODERLABS OR ITS AFFILIATES, OFFICERS, EMPLOYEES, AGENTS,
+LICENSORS, OR CONTRIBUTORS BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER
+LIABILITY (INCLUDING DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY,
+CONSEQUENTIAL, PUNITIVE, LOST PROFITS, LOST DATA, OR BUSINESS INTERRUPTION),
+WHETHER IN AN ACTION OF CONTRACT, TORT (INCLUDING NEGLIGENCE), STRICT
+LIABILITY, OR OTHERWISE, ARISING FROM, OUT OF, OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OF OR INABILITY TO USE THE SOFTWARE, EVEN IF ADVISED OF
+THE POSSIBILITY OF SUCH DAMAGE. IN NO EVENT SHALL KODERLABS' TOTAL CUMULATIVE
+LIABILITY EXCEED ONE U.S. DOLLAR (USD 1.00).
+
+================================================================================
+9. EQUITABLE RELIEF
+================================================================================
+
+The parties acknowledge that any breach of this notice would cause
+irreparable harm to KoderLabs for which monetary damages would be inadequate.
+KoderLabs is therefore entitled, in addition to all other remedies available
+at law, to specific performance and injunctive relief without the need to
+post bond.
+
+================================================================================
+10. GOVERNING LAW AND VENUE
+================================================================================
+
+This notice shall be governed by and construed in accordance with the laws
+of the Islamic Republic of Pakistan, without regard to its conflict-of-laws
+principles. Any dispute arising out of or in connection with this notice
+shall be subject to the exclusive jurisdiction of the courts of Karachi,
+Pakistan.
+
+The United Nations Convention on Contracts for the International Sale of
+Goods shall not apply.
+
+================================================================================
+11. SEVERABILITY AND ENTIRE NOTICE
+================================================================================
+
+If any provision of this notice is held invalid or unenforceable, the
+remaining provisions shall continue in full force and effect. This notice,
+together with any separate signed written licence executed between KoderLabs
+and a licensee, constitutes the entire agreement concerning the Software and
+supersedes all prior or contemporaneous understandings.
+
+================================================================================
+12. CONTACT
+================================================================================
+
+For licensing inquiries, audit requests, or notice of suspected
+infringement, contact:
+
+    KoderLabs
+    Attn: Jawaid Gadiwala
+    Email: jawaidgadiwala@gmail.com
+
+================================================================================
+END OF LICENCE
+================================================================================

package/README.md

@@ -0,0 +1,9 @@
+# Proprietary Software
+
+KoderLabs proprietary. All rights reserved.
+
+See the bundled `LICENSE` for terms. No grant of any rights, express or
+implied, is conferred by access to or possession of this package. A
+separate signed written licence from KoderLabs is required for any use.
+
+Licensing inquiries: jawaidgadiwala@gmail.com

package/dist/index.cjs

@@ -0,0 +1,96 @@
+"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/index.ts
+var index_exports = {};
+__export(index_exports, {
+  INSTANTTASKS_KEY: () => INSTANTTASKS_KEY,
+  createInstantTasksPlugin: () => createInstantTasksPlugin,
+  injectInstantTasks: () => injectInstantTasks
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/install.ts
+var import_tasks_sdk = require("@koderlabs/tasks-sdk");
+var INSTANTTASKS_KEY = /* @__PURE__ */ Symbol("instantTasks");
+function installInstantTasks(app, opts) {
+  const client = (0, import_tasks_sdk.init)(opts);
+  app.provide(INSTANTTASKS_KEY, client);
+  const existingHandler = app.config.errorHandler;
+  const wrapped = (err, instance, info) => {
+    if (typeof existingHandler === "function") {
+      try {
+        existingHandler(err, instance, info);
+      } catch (e) {
+        console.error("[InstantTasks] existing errorHandler threw", e);
+      }
+    }
+    if (typeof client.errors?.notify === "function") {
+      client.errors.notify(err instanceof Error ? err : new Error(String(err)), {
+        vueComponentInfo: info,
+        componentName: instance?.$options?.name ?? "Unknown"
+      });
+    } else {
+      const sendResult = client.send({
+        kind: "error",
+        message: err instanceof Error ? err.message : String(err),
+        stack: err instanceof Error ? err.stack : void 0,
+        vueComponentInfo: info
+      });
+      Promise.resolve(sendResult).catch(() => {
+        client.emit("send_error", { error: err });
+      });
+    }
+  };
+  app.config.errorHandler = wrapped;
+  const uninstall = () => {
+    if (app.config.errorHandler === wrapped) {
+      app.config.errorHandler = existingHandler;
+    }
+  };
+  return { client, uninstall };
+}
+
+// src/inject.ts
+var import_vue = require("vue");
+function injectInstantTasks() {
+  const client = (0, import_vue.inject)(INSTANTTASKS_KEY);
+  if (!client) {
+    throw new Error(
+      "[InstantTasks] injectInstantTasks() must be called inside setup() in a component that is a descendant of an app where app.use(createInstantTasksPlugin(...)) was called."
+    );
+  }
+  return client;
+}
+
+// src/index.ts
+function createInstantTasksPlugin(opts) {
+  return {
+    install(app) {
+      installInstantTasks(app, opts);
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  INSTANTTASKS_KEY,
+  createInstantTasksPlugin,
+  injectInstantTasks
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/install.ts","../src/inject.ts"],"sourcesContent":["import type { App } from 'vue';\nimport { installInstantTasks } from './install';\nimport type { InitOptions } from '@koderlabs/tasks-sdk';\n\nexport { injectInstantTasks } from './inject';\nexport { INSTANTTASKS_KEY } from './install';\n\n/**\n * Creates a Vue 3 Plugin that initializes the InstantTasks SDK.\n *\n * **Vue 2 is not supported.** Peer dependency is `vue: ^3`.\n *\n * @example\n * ```ts\n * import { createApp } from 'vue';\n * import { createInstantTasksPlugin } from '@koderlabs/tasks-sdk-vue';\n * import App from './App.vue';\n *\n * createApp(App)\n *   .use(createInstantTasksPlugin({ projectId: 'proj_xxx', accessKey: 'key_yyy' }))\n *   .mount('#app');\n * ```\n */\nexport function createInstantTasksPlugin(opts: InitOptions) {\n  return {\n    install(app: App) {\n      installInstantTasks(app, opts);\n    },\n  };\n}\n","import type { App } from 'vue';\nimport { init } from '@koderlabs/tasks-sdk';\nimport type { InitOptions, Client } from '@koderlabs/tasks-sdk';\n\n/** Injection key used by injectInstantTasks(). */\nexport const INSTANTTASKS_KEY = Symbol('instantTasks');\n\n/**\n * Installs the InstantTasks SDK into a Vue application.\n *\n * Called by the Plugin's `install(app)` method. Should not be called directly.\n *\n * Error handler chain order: any pre-existing `app.config.errorHandler`\n * runs FIRST, then the SDK observes/reports. This matches the\n * \"framework-first, observability-second\" convention that Pinia / Vue\n * Router / vue-i18n follow — if the host has already attached state-aware\n * error handling, it sees the error before telemetry intercepts.\n *\n * Cleanup: returns an uninstall function. `app.config.errorHandler` is\n * restored on uninstall so multiple install/uninstall cycles (Vite HMR,\n * tests) don't stack wrappers.\n */\nexport function installInstantTasks(app: App, opts: InitOptions): { client: Client; uninstall: () => void } {\n  const client = init(opts);\n\n  // Provide the client to the entire component tree via Vue's provide/inject.\n  app.provide(INSTANTTASKS_KEY, client);\n\n  const existingHandler = app.config.errorHandler;\n\n  const wrapped: NonNullable<App['config']['errorHandler']> = (err, instance, info) => {\n    // 1) Host handler first — matches framework-first convention.\n    if (typeof existingHandler === 'function') {\n      try {\n        existingHandler(err, instance, info);\n      } catch (e) {\n        // Host handler bug — log once via console.error (NOT through SDK to\n        // avoid recursion if SDK itself is the source).\n        // eslint-disable-next-line no-console\n        console.error('[InstantTasks] existing errorHandler threw', e);\n      }\n    }\n\n    // 2) Observe + ship.\n    if (typeof (client as any).errors?.notify === 'function') {\n      (client as any).errors.notify(err instanceof Error ? err : new Error(String(err)), {\n        vueComponentInfo: info,\n        componentName: instance?.$options?.name ?? 'Unknown',\n      });\n    } else {\n      // Fallback: raw send. Wrap in Promise.resolve to defend against sub-clients\n      // that return void instead of a Promise.\n      const sendResult = client.send({\n        kind: 'error',\n        message: err instanceof Error ? err.message : String(err),\n        stack: err instanceof Error ? err.stack : undefined,\n        vueComponentInfo: info,\n      } as any);\n      Promise.resolve(sendResult).catch(() => {\n        // Surface via client emit instead of silent swallow.\n        client.emit('send_error', { error: err });\n      });\n    }\n  };\n\n  app.config.errorHandler = wrapped;\n\n  // Best-effort cleanup hook for Vite HMR / tests. Vue 3 doesn't expose a\n  // first-class \"unmount\" event for the App itself; caller must invoke\n  // uninstall() during the host app's teardown sequence.\n  const uninstall = () => {\n    if (app.config.errorHandler === wrapped) {\n      app.config.errorHandler = existingHandler;\n    }\n  };\n\n  return { client, uninstall };\n}\n","import { inject } from 'vue';\nimport { INSTANTTASKS_KEY } from './install';\nimport type { Client } from '@koderlabs/tasks-sdk';\n\n/**\n * Composition-API helper: returns the InstantTasks client injected by the plugin.\n *\n * @throws When called outside of a setup() function or when the plugin has not\n * been installed on the application.\n *\n * @example\n * ```ts\n * import { injectInstantTasks } from '@koderlabs/tasks-sdk-vue';\n *\n * const { errors } = injectInstantTasks() as any;\n * errors?.notify(new Error('oops'));\n * ```\n */\nexport function injectInstantTasks(): Client {\n  const client = inject<Client>(INSTANTTASKS_KEY);\n  if (!client) {\n    throw new Error(\n      '[InstantTasks] injectInstantTasks() must be called inside setup() in a ' +\n        'component that is a descendant of an app where app.use(createInstantTasksPlugin(...)) ' +\n        'was called.',\n    );\n  }\n  return client;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACCA,uBAAqB;AAId,IAAM,mBAAmB,uBAAO,cAAc;AAiB9C,SAAS,oBAAoB,KAAU,MAA8D;AAC1G,QAAM,aAAS,uBAAK,IAAI;AAGxB,MAAI,QAAQ,kBAAkB,MAAM;AAEpC,QAAM,kBAAkB,IAAI,OAAO;AAEnC,QAAM,UAAsD,CAAC,KAAK,UAAU,SAAS;AAEnF,QAAI,OAAO,oBAAoB,YAAY;AACzC,UAAI;AACF,wBAAgB,KAAK,UAAU,IAAI;AAAA,MACrC,SAAS,GAAG;AAIV,gBAAQ,MAAM,8CAA8C,CAAC;AAAA,MAC/D;AAAA,IACF;AAGA,QAAI,OAAQ,OAAe,QAAQ,WAAW,YAAY;AACxD,MAAC,OAAe,OAAO,OAAO,eAAe,QAAQ,MAAM,IAAI,MAAM,OAAO,GAAG,CAAC,GAAG;AAAA,QACjF,kBAAkB;AAAA,QAClB,eAAe,UAAU,UAAU,QAAQ;AAAA,MAC7C,CAAC;AAAA,IACH,OAAO;AAGL,YAAM,aAAa,OAAO,KAAK;AAAA,QAC7B,MAAM;AAAA,QACN,SAAS,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAAA,QACxD,OAAO,eAAe,QAAQ,IAAI,QAAQ;AAAA,QAC1C,kBAAkB;AAAA,MACpB,CAAQ;AACR,cAAQ,QAAQ,UAAU,EAAE,MAAM,MAAM;AAEtC,eAAO,KAAK,cAAc,EAAE,OAAO,IAAI,CAAC;AAAA,MAC1C,CAAC;AAAA,IACH;AAAA,EACF;AAEA,MAAI,OAAO,eAAe;AAK1B,QAAM,YAAY,MAAM;AACtB,QAAI,IAAI,OAAO,iBAAiB,SAAS;AACvC,UAAI,OAAO,eAAe;AAAA,IAC5B;AAAA,EACF;AAEA,SAAO,EAAE,QAAQ,UAAU;AAC7B;;;AC7EA,iBAAuB;AAkBhB,SAAS,qBAA6B;AAC3C,QAAM,aAAS,mBAAe,gBAAgB;AAC9C,MAAI,CAAC,QAAQ;AACX,UAAM,IAAI;AAAA,MACR;AAAA,IAGF;AAAA,EACF;AACA,SAAO;AACT;;;AFLO,SAAS,yBAAyB,MAAmB;AAC1D,SAAO;AAAA,IACL,QAAQ,KAAU;AAChB,0BAAoB,KAAK,IAAI;AAAA,IAC/B;AAAA,EACF;AACF;","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,43 @@
+import { App } from 'vue';
+import { Client, InitOptions } from '@koderlabs/tasks-sdk';
+
+/**
+ * Composition-API helper: returns the InstantTasks client injected by the plugin.
+ *
+ * @throws When called outside of a setup() function or when the plugin has not
+ * been installed on the application.
+ *
+ * @example
+ * ```ts
+ * import { injectInstantTasks } from '@koderlabs/tasks-sdk-vue';
+ *
+ * const { errors } = injectInstantTasks() as any;
+ * errors?.notify(new Error('oops'));
+ * ```
+ */
+declare function injectInstantTasks(): Client;
+
+/** Injection key used by injectInstantTasks(). */
+declare const INSTANTTASKS_KEY: unique symbol;
+
+/**
+ * Creates a Vue 3 Plugin that initializes the InstantTasks SDK.
+ *
+ * **Vue 2 is not supported.** Peer dependency is `vue: ^3`.
+ *
+ * @example
+ * ```ts
+ * import { createApp } from 'vue';
+ * import { createInstantTasksPlugin } from '@koderlabs/tasks-sdk-vue';
+ * import App from './App.vue';
+ *
+ * createApp(App)
+ *   .use(createInstantTasksPlugin({ projectId: 'proj_xxx', accessKey: 'key_yyy' }))
+ *   .mount('#app');
+ * ```
+ */
+declare function createInstantTasksPlugin(opts: InitOptions): {
+    install(app: App): void;
+};
+
+export { INSTANTTASKS_KEY, createInstantTasksPlugin, injectInstantTasks };

package/dist/index.d.ts

@@ -0,0 +1,43 @@
+import { App } from 'vue';
+import { Client, InitOptions } from '@koderlabs/tasks-sdk';
+
+/**
+ * Composition-API helper: returns the InstantTasks client injected by the plugin.
+ *
+ * @throws When called outside of a setup() function or when the plugin has not
+ * been installed on the application.
+ *
+ * @example
+ * ```ts
+ * import { injectInstantTasks } from '@koderlabs/tasks-sdk-vue';
+ *
+ * const { errors } = injectInstantTasks() as any;
+ * errors?.notify(new Error('oops'));
+ * ```
+ */
+declare function injectInstantTasks(): Client;
+
+/** Injection key used by injectInstantTasks(). */
+declare const INSTANTTASKS_KEY: unique symbol;
+
+/**
+ * Creates a Vue 3 Plugin that initializes the InstantTasks SDK.
+ *
+ * **Vue 2 is not supported.** Peer dependency is `vue: ^3`.
+ *
+ * @example
+ * ```ts
+ * import { createApp } from 'vue';
+ * import { createInstantTasksPlugin } from '@koderlabs/tasks-sdk-vue';
+ * import App from './App.vue';
+ *
+ * createApp(App)
+ *   .use(createInstantTasksPlugin({ projectId: 'proj_xxx', accessKey: 'key_yyy' }))
+ *   .mount('#app');
+ * ```
+ */
+declare function createInstantTasksPlugin(opts: InitOptions): {
+    install(app: App): void;
+};
+
+export { INSTANTTASKS_KEY, createInstantTasksPlugin, injectInstantTasks };

package/dist/index.js

@@ -0,0 +1,67 @@
+// src/install.ts
+import { init } from "@koderlabs/tasks-sdk";
+var INSTANTTASKS_KEY = /* @__PURE__ */ Symbol("instantTasks");
+function installInstantTasks(app, opts) {
+  const client = init(opts);
+  app.provide(INSTANTTASKS_KEY, client);
+  const existingHandler = app.config.errorHandler;
+  const wrapped = (err, instance, info) => {
+    if (typeof existingHandler === "function") {
+      try {
+        existingHandler(err, instance, info);
+      } catch (e) {
+        console.error("[InstantTasks] existing errorHandler threw", e);
+      }
+    }
+    if (typeof client.errors?.notify === "function") {
+      client.errors.notify(err instanceof Error ? err : new Error(String(err)), {
+        vueComponentInfo: info,
+        componentName: instance?.$options?.name ?? "Unknown"
+      });
+    } else {
+      const sendResult = client.send({
+        kind: "error",
+        message: err instanceof Error ? err.message : String(err),
+        stack: err instanceof Error ? err.stack : void 0,
+        vueComponentInfo: info
+      });
+      Promise.resolve(sendResult).catch(() => {
+        client.emit("send_error", { error: err });
+      });
+    }
+  };
+  app.config.errorHandler = wrapped;
+  const uninstall = () => {
+    if (app.config.errorHandler === wrapped) {
+      app.config.errorHandler = existingHandler;
+    }
+  };
+  return { client, uninstall };
+}
+
+// src/inject.ts
+import { inject } from "vue";
+function injectInstantTasks() {
+  const client = inject(INSTANTTASKS_KEY);
+  if (!client) {
+    throw new Error(
+      "[InstantTasks] injectInstantTasks() must be called inside setup() in a component that is a descendant of an app where app.use(createInstantTasksPlugin(...)) was called."
+    );
+  }
+  return client;
+}
+
+// src/index.ts
+function createInstantTasksPlugin(opts) {
+  return {
+    install(app) {
+      installInstantTasks(app, opts);
+    }
+  };
+}
+export {
+  INSTANTTASKS_KEY,
+  createInstantTasksPlugin,
+  injectInstantTasks
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/install.ts","../src/inject.ts","../src/index.ts"],"sourcesContent":["import type { App } from 'vue';\nimport { init } from '@koderlabs/tasks-sdk';\nimport type { InitOptions, Client } from '@koderlabs/tasks-sdk';\n\n/** Injection key used by injectInstantTasks(). */\nexport const INSTANTTASKS_KEY = Symbol('instantTasks');\n\n/**\n * Installs the InstantTasks SDK into a Vue application.\n *\n * Called by the Plugin's `install(app)` method. Should not be called directly.\n *\n * Error handler chain order: any pre-existing `app.config.errorHandler`\n * runs FIRST, then the SDK observes/reports. This matches the\n * \"framework-first, observability-second\" convention that Pinia / Vue\n * Router / vue-i18n follow — if the host has already attached state-aware\n * error handling, it sees the error before telemetry intercepts.\n *\n * Cleanup: returns an uninstall function. `app.config.errorHandler` is\n * restored on uninstall so multiple install/uninstall cycles (Vite HMR,\n * tests) don't stack wrappers.\n */\nexport function installInstantTasks(app: App, opts: InitOptions): { client: Client; uninstall: () => void } {\n  const client = init(opts);\n\n  // Provide the client to the entire component tree via Vue's provide/inject.\n  app.provide(INSTANTTASKS_KEY, client);\n\n  const existingHandler = app.config.errorHandler;\n\n  const wrapped: NonNullable<App['config']['errorHandler']> = (err, instance, info) => {\n    // 1) Host handler first — matches framework-first convention.\n    if (typeof existingHandler === 'function') {\n      try {\n        existingHandler(err, instance, info);\n      } catch (e) {\n        // Host handler bug — log once via console.error (NOT through SDK to\n        // avoid recursion if SDK itself is the source).\n        // eslint-disable-next-line no-console\n        console.error('[InstantTasks] existing errorHandler threw', e);\n      }\n    }\n\n    // 2) Observe + ship.\n    if (typeof (client as any).errors?.notify === 'function') {\n      (client as any).errors.notify(err instanceof Error ? err : new Error(String(err)), {\n        vueComponentInfo: info,\n        componentName: instance?.$options?.name ?? 'Unknown',\n      });\n    } else {\n      // Fallback: raw send. Wrap in Promise.resolve to defend against sub-clients\n      // that return void instead of a Promise.\n      const sendResult = client.send({\n        kind: 'error',\n        message: err instanceof Error ? err.message : String(err),\n        stack: err instanceof Error ? err.stack : undefined,\n        vueComponentInfo: info,\n      } as any);\n      Promise.resolve(sendResult).catch(() => {\n        // Surface via client emit instead of silent swallow.\n        client.emit('send_error', { error: err });\n      });\n    }\n  };\n\n  app.config.errorHandler = wrapped;\n\n  // Best-effort cleanup hook for Vite HMR / tests. Vue 3 doesn't expose a\n  // first-class \"unmount\" event for the App itself; caller must invoke\n  // uninstall() during the host app's teardown sequence.\n  const uninstall = () => {\n    if (app.config.errorHandler === wrapped) {\n      app.config.errorHandler = existingHandler;\n    }\n  };\n\n  return { client, uninstall };\n}\n","import { inject } from 'vue';\nimport { INSTANTTASKS_KEY } from './install';\nimport type { Client } from '@koderlabs/tasks-sdk';\n\n/**\n * Composition-API helper: returns the InstantTasks client injected by the plugin.\n *\n * @throws When called outside of a setup() function or when the plugin has not\n * been installed on the application.\n *\n * @example\n * ```ts\n * import { injectInstantTasks } from '@koderlabs/tasks-sdk-vue';\n *\n * const { errors } = injectInstantTasks() as any;\n * errors?.notify(new Error('oops'));\n * ```\n */\nexport function injectInstantTasks(): Client {\n  const client = inject<Client>(INSTANTTASKS_KEY);\n  if (!client) {\n    throw new Error(\n      '[InstantTasks] injectInstantTasks() must be called inside setup() in a ' +\n        'component that is a descendant of an app where app.use(createInstantTasksPlugin(...)) ' +\n        'was called.',\n    );\n  }\n  return client;\n}\n","import type { App } from 'vue';\nimport { installInstantTasks } from './install';\nimport type { InitOptions } from '@koderlabs/tasks-sdk';\n\nexport { injectInstantTasks } from './inject';\nexport { INSTANTTASKS_KEY } from './install';\n\n/**\n * Creates a Vue 3 Plugin that initializes the InstantTasks SDK.\n *\n * **Vue 2 is not supported.** Peer dependency is `vue: ^3`.\n *\n * @example\n * ```ts\n * import { createApp } from 'vue';\n * import { createInstantTasksPlugin } from '@koderlabs/tasks-sdk-vue';\n * import App from './App.vue';\n *\n * createApp(App)\n *   .use(createInstantTasksPlugin({ projectId: 'proj_xxx', accessKey: 'key_yyy' }))\n *   .mount('#app');\n * ```\n */\nexport function createInstantTasksPlugin(opts: InitOptions) {\n  return {\n    install(app: App) {\n      installInstantTasks(app, opts);\n    },\n  };\n}\n"],"mappings":";AACA,SAAS,YAAY;AAId,IAAM,mBAAmB,uBAAO,cAAc;AAiB9C,SAAS,oBAAoB,KAAU,MAA8D;AAC1G,QAAM,SAAS,KAAK,IAAI;AAGxB,MAAI,QAAQ,kBAAkB,MAAM;AAEpC,QAAM,kBAAkB,IAAI,OAAO;AAEnC,QAAM,UAAsD,CAAC,KAAK,UAAU,SAAS;AAEnF,QAAI,OAAO,oBAAoB,YAAY;AACzC,UAAI;AACF,wBAAgB,KAAK,UAAU,IAAI;AAAA,MACrC,SAAS,GAAG;AAIV,gBAAQ,MAAM,8CAA8C,CAAC;AAAA,MAC/D;AAAA,IACF;AAGA,QAAI,OAAQ,OAAe,QAAQ,WAAW,YAAY;AACxD,MAAC,OAAe,OAAO,OAAO,eAAe,QAAQ,MAAM,IAAI,MAAM,OAAO,GAAG,CAAC,GAAG;AAAA,QACjF,kBAAkB;AAAA,QAClB,eAAe,UAAU,UAAU,QAAQ;AAAA,MAC7C,CAAC;AAAA,IACH,OAAO;AAGL,YAAM,aAAa,OAAO,KAAK;AAAA,QAC7B,MAAM;AAAA,QACN,SAAS,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAAA,QACxD,OAAO,eAAe,QAAQ,IAAI,QAAQ;AAAA,QAC1C,kBAAkB;AAAA,MACpB,CAAQ;AACR,cAAQ,QAAQ,UAAU,EAAE,MAAM,MAAM;AAEtC,eAAO,KAAK,cAAc,EAAE,OAAO,IAAI,CAAC;AAAA,MAC1C,CAAC;AAAA,IACH;AAAA,EACF;AAEA,MAAI,OAAO,eAAe;AAK1B,QAAM,YAAY,MAAM;AACtB,QAAI,IAAI,OAAO,iBAAiB,SAAS;AACvC,UAAI,OAAO,eAAe;AAAA,IAC5B;AAAA,EACF;AAEA,SAAO,EAAE,QAAQ,UAAU;AAC7B;;;AC7EA,SAAS,cAAc;AAkBhB,SAAS,qBAA6B;AAC3C,QAAM,SAAS,OAAe,gBAAgB;AAC9C,MAAI,CAAC,QAAQ;AACX,UAAM,IAAI;AAAA,MACR;AAAA,IAGF;AAAA,EACF;AACA,SAAO;AACT;;;ACLO,SAAS,yBAAyB,MAAmB;AAC1D,SAAO;AAAA,IACL,QAAQ,KAAU;AAChB,0BAAoB,KAAK,IAAI;AAAA,IAC/B;AAAA,EACF;AACF;","names":[]}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@koderlabs/tasks-sdk-vue",
+  "version": "0.1.0",
+  "description": "Vue 3 plugin for the InstantTasks SDK.",
+  "keywords": [
+    "instanttasks",
+    "sdk",
+    "vue"
+  ],
+  "homepage": "https://github.com/jawaidgadiwala/instant-tasks/tree/main/packages/sdk-vue#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-vue"
+  },
+  "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"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "dependencies": {
+    "@koderlabs/tasks-sdk": "0.1.0"
+  },
+  "peerDependencies": {
+    "vue": "^3"
+  },
+  "devDependencies": {
+    "@vue/test-utils": "^2.4.0",
+    "jsdom": "^25.0.0",
+    "tsup": "^8.3.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.1.0",
+    "vue": "^3.5.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}