@koderlabs/tasks-sdk-types 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,131 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+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, {
+  ACCESS_KEY_PREFIX: () => ACCESS_KEY_PREFIX,
+  ALL_SCOPES: () => ALL_SCOPES,
+  DEFAULT_INGEST_SCOPES: () => DEFAULT_INGEST_SCOPES,
+  DEFAULT_MANAGEMENT_SCOPES: () => DEFAULT_MANAGEMENT_SCOPES,
+  EVENT_KIND_VALUES: () => EVENT_KIND_VALUES,
+  INGEST_EVENT_KIND_VALUES: () => INGEST_EVENT_KIND_VALUES,
+  PROJECT_ID_PREFIX: () => PROJECT_ID_PREFIX,
+  PROJECT_KEY_KINDS: () => PROJECT_KEY_KINDS,
+  PROJECT_KEY_PREFIX: () => PROJECT_KEY_PREFIX,
+  PROJECT_KEY_TYPES: () => PROJECT_KEY_TYPES,
+  SCOPE: () => SCOPE,
+  SECRET_KEY_PREFIX: () => SECRET_KEY_PREFIX,
+  isAccessKey: () => isAccessKey,
+  isProjectId: () => isProjectId,
+  isSecretKey: () => isSecretKey,
+  isValidScope: () => isValidScope
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/keys.ts
+var PROJECT_ID_PREFIX = "proj_";
+var ACCESS_KEY_PREFIX = "ik_live_";
+var SECRET_KEY_PREFIX = "sk_live_";
+var PROJECT_KEY_TYPES = [
+  "ingest",
+  "management"
+];
+var PROJECT_KEY_PREFIX = {
+  ingest: ACCESS_KEY_PREFIX,
+  management: SECRET_KEY_PREFIX
+};
+var PROJECT_KEY_KINDS = PROJECT_KEY_TYPES;
+function isProjectId(v) {
+  return v.startsWith(PROJECT_ID_PREFIX);
+}
+__name(isProjectId, "isProjectId");
+function isAccessKey(v) {
+  return v.startsWith(ACCESS_KEY_PREFIX);
+}
+__name(isAccessKey, "isAccessKey");
+function isSecretKey(v) {
+  return v.startsWith(SECRET_KEY_PREFIX);
+}
+__name(isSecretKey, "isSecretKey");
+
+// src/events.ts
+var EVENT_KIND_VALUES = [
+  "bug_report",
+  "error",
+  "breadcrumb",
+  "session",
+  "web_vital"
+];
+var INGEST_EVENT_KIND_VALUES = [
+  "bug_report",
+  "error",
+  "breadcrumb",
+  "web_vital"
+];
+
+// src/scopes.ts
+var SCOPE = {
+  WIDGET_SUBMIT: "widget:submit",
+  EVENT_READ: "event:read",
+  EVENT_WRITE: "event:write",
+  PROJECT_READ: "project:read",
+  PROJECT_WRITE: "project:write",
+  TICKET_READ: "ticket:read",
+  TICKET_WRITE: "ticket:write",
+  TEAM_READ: "team:read",
+  TEAM_WRITE: "team:write",
+  BULK_ADMIN: "bulk:admin"
+};
+var ALL_SCOPES = Object.values(SCOPE);
+var DEFAULT_INGEST_SCOPES = [
+  SCOPE.WIDGET_SUBMIT,
+  SCOPE.EVENT_WRITE
+];
+var DEFAULT_MANAGEMENT_SCOPES = [
+  SCOPE.EVENT_READ,
+  SCOPE.EVENT_WRITE,
+  SCOPE.PROJECT_READ,
+  SCOPE.TICKET_READ,
+  SCOPE.TICKET_WRITE
+];
+function isValidScope(s) {
+  return ALL_SCOPES.includes(s);
+}
+__name(isValidScope, "isValidScope");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ACCESS_KEY_PREFIX,
+  ALL_SCOPES,
+  DEFAULT_INGEST_SCOPES,
+  DEFAULT_MANAGEMENT_SCOPES,
+  EVENT_KIND_VALUES,
+  INGEST_EVENT_KIND_VALUES,
+  PROJECT_ID_PREFIX,
+  PROJECT_KEY_KINDS,
+  PROJECT_KEY_PREFIX,
+  PROJECT_KEY_TYPES,
+  SCOPE,
+  SECRET_KEY_PREFIX,
+  isAccessKey,
+  isProjectId,
+  isSecretKey,
+  isValidScope
+});

package/dist/index.d.cts

@@ -0,0 +1,149 @@
+declare const projectIdBrand: unique symbol;
+declare const accessKeyBrand: unique symbol;
+declare const secretKeyBrand: unique symbol;
+type ProjectId = string & {
+    readonly [projectIdBrand]: true;
+};
+type AccessKey = string & {
+    readonly [accessKeyBrand]: true;
+};
+type SecretKey = string & {
+    readonly [secretKeyBrand]: true;
+};
+declare const PROJECT_ID_PREFIX = "proj_";
+declare const ACCESS_KEY_PREFIX = "ik_live_";
+declare const SECRET_KEY_PREFIX = "sk_live_";
+/**
+ * Project key type. `ingest` mints an access (publishable) key used by the
+ * browser SDK; `management` mints a secret key used server-to-server / MCP.
+ */
+type ProjectKeyType = 'ingest' | 'management';
+declare const PROJECT_KEY_TYPES: readonly ProjectKeyType[];
+/** Prefix table keyed by type — single source of truth for plaintext minting. */
+declare const PROJECT_KEY_PREFIX: Record<ProjectKeyType, string>;
+/** @deprecated use {@link ProjectKeyType} */
+type ProjectKeyKind = ProjectKeyType;
+/** @deprecated use {@link PROJECT_KEY_TYPES} */
+declare const PROJECT_KEY_KINDS: readonly ProjectKeyType[];
+declare function isProjectId(v: string): v is ProjectId;
+declare function isAccessKey(v: string): v is AccessKey;
+declare function isSecretKey(v: string): v is SecretKey;
+
+type Serializable = string | number | boolean | null | Serializable[] | {
+    [key: string]: Serializable;
+};
+type EventKind = 'bug_report' | 'error' | 'breadcrumb' | 'session' | 'web_vital';
+/** All event kinds the SDK transport can emit. Single source of truth for
+ *  validation pipes (class-validator `@IsIn`) and runtime checks. */
+declare const EVENT_KIND_VALUES: readonly EventKind[];
+/** Subset accepted by the v1 ingest endpoint (session events stream
+ *  separately via the replay channel, not the event submission DTO). */
+type IngestEventKind = Exclude<EventKind, 'session'>;
+declare const INGEST_EVENT_KIND_VALUES: readonly IngestEventKind[];
+type WebVitalName = 'LCP' | 'INP' | 'CLS' | 'FCP' | 'TTFB';
+interface WebVitalEvent extends EventEnvelopeBase<'web_vital'> {
+    metric: WebVitalName;
+    value: number;
+    rating: 'good' | 'needs-improvement' | 'poor';
+    /** Unique measurement id from web-vitals lib (allows dedup) */
+    measurementId?: string;
+    navigationType?: string;
+}
+interface EventEnvelopeBase<K extends EventKind> {
+    kind: K;
+    ts: string;
+    release?: string;
+    environment?: string;
+    user?: {
+        id?: string;
+        email?: string;
+        username?: string;
+        [key: string]: unknown;
+    };
+    url: string;
+    userAgent: string;
+    viewport: {
+        width: number;
+        height: number;
+    };
+    custom?: Record<string, Serializable>;
+}
+interface BugReportEvent extends EventEnvelopeBase<'bug_report'> {
+    title?: string;
+    description: string;
+    email?: string;
+    annotations?: Array<{
+        type: 'highlight' | 'hide';
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    }>;
+}
+/** Stack frame as emitted by browser/RN SDK parsers and ingested by the API. */
+interface Frame {
+    filename: string | null;
+    function: string | null;
+    lineno: number | null;
+    colno: number | null;
+    in_app: boolean;
+}
+type ErrorLevel = 'fatal' | 'error' | 'warning' | 'info' | 'debug';
+interface ErrorEvent extends EventEnvelopeBase<'error'> {
+    exception: {
+        type: string;
+        value: string;
+        /** Parsed frames — canonical shape consumed by apps/api error.handler */
+        stacktrace: {
+            frames: Frame[];
+        };
+        /** Raw stack string (optional, retained for forensic / unparsed transports) */
+        stack?: string;
+        /** Origin of capture, optional for backwards-compat */
+        mechanism?: 'onerror' | 'unhandledrejection' | 'notify';
+    };
+    level: ErrorLevel;
+    breadcrumbs?: Breadcrumb[];
+    fingerprint?: string[];
+    /** Captured network requests preceding the error (sdk-network ring). */
+    networkRing?: unknown[];
+    /** Active feature flags at the time of the error. */
+    featureFlags?: Array<{
+        name: string;
+        variant: string | boolean | number;
+    }>;
+    /** Arbitrary key→object metadata grouped by namespace (e.g. `device`, `app`). */
+    contexts?: Record<string, unknown>;
+}
+type BreadcrumbCategory = 'xhr' | 'fetch' | 'ui' | 'navigation' | 'console' | 'error' | 'user' | 'http' | 'custom';
+type BreadcrumbLevel = 'debug' | 'info' | 'warning' | 'error';
+interface Breadcrumb {
+    /** ISO 8601 timestamp. SDK writes `timestamp`; handlers do not read this
+     *  field today, so the canonical name follows what the SDK + tests emit. */
+    timestamp: string;
+    category: BreadcrumbCategory;
+    message: string;
+    level?: BreadcrumbLevel;
+    data?: Record<string, unknown>;
+}
+type AnyEvent = BugReportEvent | ErrorEvent | WebVitalEvent;
+
+declare const SCOPE: {
+    readonly WIDGET_SUBMIT: "widget:submit";
+    readonly EVENT_READ: "event:read";
+    readonly EVENT_WRITE: "event:write";
+    readonly PROJECT_READ: "project:read";
+    readonly PROJECT_WRITE: "project:write";
+    readonly TICKET_READ: "ticket:read";
+    readonly TICKET_WRITE: "ticket:write";
+    readonly TEAM_READ: "team:read";
+    readonly TEAM_WRITE: "team:write";
+    readonly BULK_ADMIN: "bulk:admin";
+};
+type Scope = typeof SCOPE[keyof typeof SCOPE];
+declare const ALL_SCOPES: Scope[];
+declare const DEFAULT_INGEST_SCOPES: Scope[];
+declare const DEFAULT_MANAGEMENT_SCOPES: Scope[];
+declare function isValidScope(s: string): s is Scope;
+
+export { ACCESS_KEY_PREFIX, ALL_SCOPES, type AccessKey, type AnyEvent, type Breadcrumb, type BreadcrumbCategory, type BreadcrumbLevel, type BugReportEvent, DEFAULT_INGEST_SCOPES, DEFAULT_MANAGEMENT_SCOPES, EVENT_KIND_VALUES, type ErrorEvent, type ErrorLevel, type EventEnvelopeBase, type EventKind, type Frame, INGEST_EVENT_KIND_VALUES, type IngestEventKind, PROJECT_ID_PREFIX, PROJECT_KEY_KINDS, PROJECT_KEY_PREFIX, PROJECT_KEY_TYPES, type ProjectId, type ProjectKeyKind, type ProjectKeyType, SCOPE, SECRET_KEY_PREFIX, type Scope, type SecretKey, type Serializable, type WebVitalEvent, type WebVitalName, isAccessKey, isProjectId, isSecretKey, isValidScope };

package/dist/index.d.ts

@@ -0,0 +1,149 @@
+declare const projectIdBrand: unique symbol;
+declare const accessKeyBrand: unique symbol;
+declare const secretKeyBrand: unique symbol;
+type ProjectId = string & {
+    readonly [projectIdBrand]: true;
+};
+type AccessKey = string & {
+    readonly [accessKeyBrand]: true;
+};
+type SecretKey = string & {
+    readonly [secretKeyBrand]: true;
+};
+declare const PROJECT_ID_PREFIX = "proj_";
+declare const ACCESS_KEY_PREFIX = "ik_live_";
+declare const SECRET_KEY_PREFIX = "sk_live_";
+/**
+ * Project key type. `ingest` mints an access (publishable) key used by the
+ * browser SDK; `management` mints a secret key used server-to-server / MCP.
+ */
+type ProjectKeyType = 'ingest' | 'management';
+declare const PROJECT_KEY_TYPES: readonly ProjectKeyType[];
+/** Prefix table keyed by type — single source of truth for plaintext minting. */
+declare const PROJECT_KEY_PREFIX: Record<ProjectKeyType, string>;
+/** @deprecated use {@link ProjectKeyType} */
+type ProjectKeyKind = ProjectKeyType;
+/** @deprecated use {@link PROJECT_KEY_TYPES} */
+declare const PROJECT_KEY_KINDS: readonly ProjectKeyType[];
+declare function isProjectId(v: string): v is ProjectId;
+declare function isAccessKey(v: string): v is AccessKey;
+declare function isSecretKey(v: string): v is SecretKey;
+
+type Serializable = string | number | boolean | null | Serializable[] | {
+    [key: string]: Serializable;
+};
+type EventKind = 'bug_report' | 'error' | 'breadcrumb' | 'session' | 'web_vital';
+/** All event kinds the SDK transport can emit. Single source of truth for
+ *  validation pipes (class-validator `@IsIn`) and runtime checks. */
+declare const EVENT_KIND_VALUES: readonly EventKind[];
+/** Subset accepted by the v1 ingest endpoint (session events stream
+ *  separately via the replay channel, not the event submission DTO). */
+type IngestEventKind = Exclude<EventKind, 'session'>;
+declare const INGEST_EVENT_KIND_VALUES: readonly IngestEventKind[];
+type WebVitalName = 'LCP' | 'INP' | 'CLS' | 'FCP' | 'TTFB';
+interface WebVitalEvent extends EventEnvelopeBase<'web_vital'> {
+    metric: WebVitalName;
+    value: number;
+    rating: 'good' | 'needs-improvement' | 'poor';
+    /** Unique measurement id from web-vitals lib (allows dedup) */
+    measurementId?: string;
+    navigationType?: string;
+}
+interface EventEnvelopeBase<K extends EventKind> {
+    kind: K;
+    ts: string;
+    release?: string;
+    environment?: string;
+    user?: {
+        id?: string;
+        email?: string;
+        username?: string;
+        [key: string]: unknown;
+    };
+    url: string;
+    userAgent: string;
+    viewport: {
+        width: number;
+        height: number;
+    };
+    custom?: Record<string, Serializable>;
+}
+interface BugReportEvent extends EventEnvelopeBase<'bug_report'> {
+    title?: string;
+    description: string;
+    email?: string;
+    annotations?: Array<{
+        type: 'highlight' | 'hide';
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    }>;
+}
+/** Stack frame as emitted by browser/RN SDK parsers and ingested by the API. */
+interface Frame {
+    filename: string | null;
+    function: string | null;
+    lineno: number | null;
+    colno: number | null;
+    in_app: boolean;
+}
+type ErrorLevel = 'fatal' | 'error' | 'warning' | 'info' | 'debug';
+interface ErrorEvent extends EventEnvelopeBase<'error'> {
+    exception: {
+        type: string;
+        value: string;
+        /** Parsed frames — canonical shape consumed by apps/api error.handler */
+        stacktrace: {
+            frames: Frame[];
+        };
+        /** Raw stack string (optional, retained for forensic / unparsed transports) */
+        stack?: string;
+        /** Origin of capture, optional for backwards-compat */
+        mechanism?: 'onerror' | 'unhandledrejection' | 'notify';
+    };
+    level: ErrorLevel;
+    breadcrumbs?: Breadcrumb[];
+    fingerprint?: string[];
+    /** Captured network requests preceding the error (sdk-network ring). */
+    networkRing?: unknown[];
+    /** Active feature flags at the time of the error. */
+    featureFlags?: Array<{
+        name: string;
+        variant: string | boolean | number;
+    }>;
+    /** Arbitrary key→object metadata grouped by namespace (e.g. `device`, `app`). */
+    contexts?: Record<string, unknown>;
+}
+type BreadcrumbCategory = 'xhr' | 'fetch' | 'ui' | 'navigation' | 'console' | 'error' | 'user' | 'http' | 'custom';
+type BreadcrumbLevel = 'debug' | 'info' | 'warning' | 'error';
+interface Breadcrumb {
+    /** ISO 8601 timestamp. SDK writes `timestamp`; handlers do not read this
+     *  field today, so the canonical name follows what the SDK + tests emit. */
+    timestamp: string;
+    category: BreadcrumbCategory;
+    message: string;
+    level?: BreadcrumbLevel;
+    data?: Record<string, unknown>;
+}
+type AnyEvent = BugReportEvent | ErrorEvent | WebVitalEvent;
+
+declare const SCOPE: {
+    readonly WIDGET_SUBMIT: "widget:submit";
+    readonly EVENT_READ: "event:read";
+    readonly EVENT_WRITE: "event:write";
+    readonly PROJECT_READ: "project:read";
+    readonly PROJECT_WRITE: "project:write";
+    readonly TICKET_READ: "ticket:read";
+    readonly TICKET_WRITE: "ticket:write";
+    readonly TEAM_READ: "team:read";
+    readonly TEAM_WRITE: "team:write";
+    readonly BULK_ADMIN: "bulk:admin";
+};
+type Scope = typeof SCOPE[keyof typeof SCOPE];
+declare const ALL_SCOPES: Scope[];
+declare const DEFAULT_INGEST_SCOPES: Scope[];
+declare const DEFAULT_MANAGEMENT_SCOPES: Scope[];
+declare function isValidScope(s: string): s is Scope;
+
+export { ACCESS_KEY_PREFIX, ALL_SCOPES, type AccessKey, type AnyEvent, type Breadcrumb, type BreadcrumbCategory, type BreadcrumbLevel, type BugReportEvent, DEFAULT_INGEST_SCOPES, DEFAULT_MANAGEMENT_SCOPES, EVENT_KIND_VALUES, type ErrorEvent, type ErrorLevel, type EventEnvelopeBase, type EventKind, type Frame, INGEST_EVENT_KIND_VALUES, type IngestEventKind, PROJECT_ID_PREFIX, PROJECT_KEY_KINDS, PROJECT_KEY_PREFIX, PROJECT_KEY_TYPES, type ProjectId, type ProjectKeyKind, type ProjectKeyType, SCOPE, SECRET_KEY_PREFIX, type Scope, type SecretKey, type Serializable, type WebVitalEvent, type WebVitalName, isAccessKey, isProjectId, isSecretKey, isValidScope };

package/dist/index.js

@@ -0,0 +1,91 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/keys.ts
+var PROJECT_ID_PREFIX = "proj_";
+var ACCESS_KEY_PREFIX = "ik_live_";
+var SECRET_KEY_PREFIX = "sk_live_";
+var PROJECT_KEY_TYPES = [
+  "ingest",
+  "management"
+];
+var PROJECT_KEY_PREFIX = {
+  ingest: ACCESS_KEY_PREFIX,
+  management: SECRET_KEY_PREFIX
+};
+var PROJECT_KEY_KINDS = PROJECT_KEY_TYPES;
+function isProjectId(v) {
+  return v.startsWith(PROJECT_ID_PREFIX);
+}
+__name(isProjectId, "isProjectId");
+function isAccessKey(v) {
+  return v.startsWith(ACCESS_KEY_PREFIX);
+}
+__name(isAccessKey, "isAccessKey");
+function isSecretKey(v) {
+  return v.startsWith(SECRET_KEY_PREFIX);
+}
+__name(isSecretKey, "isSecretKey");
+
+// src/events.ts
+var EVENT_KIND_VALUES = [
+  "bug_report",
+  "error",
+  "breadcrumb",
+  "session",
+  "web_vital"
+];
+var INGEST_EVENT_KIND_VALUES = [
+  "bug_report",
+  "error",
+  "breadcrumb",
+  "web_vital"
+];
+
+// src/scopes.ts
+var SCOPE = {
+  WIDGET_SUBMIT: "widget:submit",
+  EVENT_READ: "event:read",
+  EVENT_WRITE: "event:write",
+  PROJECT_READ: "project:read",
+  PROJECT_WRITE: "project:write",
+  TICKET_READ: "ticket:read",
+  TICKET_WRITE: "ticket:write",
+  TEAM_READ: "team:read",
+  TEAM_WRITE: "team:write",
+  BULK_ADMIN: "bulk:admin"
+};
+var ALL_SCOPES = Object.values(SCOPE);
+var DEFAULT_INGEST_SCOPES = [
+  SCOPE.WIDGET_SUBMIT,
+  SCOPE.EVENT_WRITE
+];
+var DEFAULT_MANAGEMENT_SCOPES = [
+  SCOPE.EVENT_READ,
+  SCOPE.EVENT_WRITE,
+  SCOPE.PROJECT_READ,
+  SCOPE.TICKET_READ,
+  SCOPE.TICKET_WRITE
+];
+function isValidScope(s) {
+  return ALL_SCOPES.includes(s);
+}
+__name(isValidScope, "isValidScope");
+export {
+  ACCESS_KEY_PREFIX,
+  ALL_SCOPES,
+  DEFAULT_INGEST_SCOPES,
+  DEFAULT_MANAGEMENT_SCOPES,
+  EVENT_KIND_VALUES,
+  INGEST_EVENT_KIND_VALUES,
+  PROJECT_ID_PREFIX,
+  PROJECT_KEY_KINDS,
+  PROJECT_KEY_PREFIX,
+  PROJECT_KEY_TYPES,
+  SCOPE,
+  SECRET_KEY_PREFIX,
+  isAccessKey,
+  isProjectId,
+  isSecretKey,
+  isValidScope
+};

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@koderlabs/tasks-sdk-types",
+  "version": "0.1.0",
+  "description": "Shared TypeScript types for the InstantTasks SDK suite.",
+  "keywords": [
+    "instanttasks",
+    "sdk",
+    "types"
+  ],
+  "homepage": "https://github.com/jawaidgadiwala/instant-tasks/tree/main/packages/sdk-types#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-types"
+  },
+  "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,
+  "devDependencies": {
+    "tsup": "^8.3.0",
+    "typescript": "^5.5.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts --clean",
+    "dev": "tsup src/index.ts --format esm,cjs --dts --watch"
+  }
+}