swiftproof 0.1.0

package/dist/index.js

@@ -0,0 +1,119 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+// src/index.ts
+var SwiftProof = class {
+  constructor(config) {
+    /** All chain of custody operations */
+    this.chains = {
+      /**
+       * Create a new chain of custody.
+       *
+       * Call this when a real-world handoff event begins:
+       * an order is placed, a delivery is dispatched,
+       * an inspection is scheduled, a document is to be served.
+       *
+       * Returns confirmation URLs for each actor and a
+       * tracking URL for the end recipient.
+       *
+       * @example
+       * ```typescript
+       * const chain = await sp.chains.create({
+       *   title: 'Order #1234',
+       *   actors: [
+       *     { event: 'packed',    actor: 'Kitchen' },
+       *     { event: 'delivered', actor: 'Rider' },
+       *   ],
+       * });
+       *
+       * // Kitchen taps this link → GPS captured → "packed" confirmed
+       * chain.handoffs[0].confirmation_url
+       *
+       * // Customer opens this → sees live status timeline
+       * chain.tracking_url
+       * ```
+       */
+      create: (input) => this.request("POST", "/v1/chains", input),
+      /**
+       * Get the full audit trail for a chain.
+       *
+       * Shows every step — confirmed or pending —
+       * with all captured evidence: GPS, timestamp, photo, hash.
+       *
+       * @example
+       * ```typescript
+       * const detail = await sp.chains.get('sp_ch_abc123');
+       * detail.trail.forEach(step => {
+       *   console.log(step.event, step.confirmed_at, step.location);
+       * });
+       * ```
+       */
+      get: (chainId) => this.request("GET", `/v1/chains/${chainId}`),
+      /**
+       * Verify a completed chain of custody.
+       *
+       * Recomputes every hash in the chain and confirms nothing
+       * was altered after the fact.
+       *
+       * Use this when:
+       * - A customer disputes a delivery
+       * - A regulator asks for proof
+       * - An auditor needs to confirm records are untampered
+       *
+       * @returns VerificationResult with verified: true if chain is
+       * complete and cryptographically intact
+       *
+       * @example
+       * ```typescript
+       * const proof = await sp.chains.verify('sp_ch_abc123');
+       *
+       * if (proof.verified) {
+       *   // Chain is complete and untampered
+       *   // Show proof.trail as evidence
+       * } else if (proof.tampered) {
+       *   // Records were altered — do not use as evidence
+       * } else {
+       *   // Chain not yet complete — some steps pending
+       * }
+       * ```
+       */
+      verify: (chainId) => this.request("GET", `/v1/chains/${chainId}/verify`)
+    };
+    var _a;
+    if (!config.apiKey) throw new Error("SwiftProof: apiKey is required");
+    if (!config.apiKey.startsWith("sp_")) {
+      throw new Error(
+        "SwiftProof: apiKey must start with sp_live_ or sp_test_"
+      );
+    }
+    this.baseUrl = ((_a = config.baseUrl) != null ? _a : "https://swiftproof-infra.onrender.com").replace(/\/$/, "");
+    this.headers = {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${config.apiKey}`
+    };
+  }
+  async request(method, path, body) {
+    var _a;
+    const res = await fetch(`${this.baseUrl}${path}`, {
+      method,
+      headers: this.headers,
+      body: body !== void 0 ? JSON.stringify(body) : void 0
+    });
+    const data = await res.json().catch(() => ({}));
+    if (!res.ok) {
+      const message = (_a = data == null ? void 0 : data.message) != null ? _a : `Request failed with status ${res.status}`;
+      const err = new Error(`SwiftProof API error: ${message}`);
+      err.status = res.status;
+      err.response = data;
+      throw err;
+    }
+    return data;
+  }
+};
+var index_default = SwiftProof;
+
+exports.SwiftProof = SwiftProof;
+exports.default = index_default;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;;;AAmVO,IAAM,aAAN,MAAiB;AAAA,EAItB,YAAY,MAAA,EAA0B;AA0CtC;AAAA,IAAA,IAAA,CAAS,MAAA,GAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MA4BhB,QAAQ,CAAC,KAAA,KACP,KAAK,OAAA,CAAe,MAAA,EAAQ,cAAc,KAAK,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAgBjD,GAAA,EAAK,CAAC,OAAA,KACJ,IAAA,CAAK,QAAqB,KAAA,EAAO,CAAA,WAAA,EAAc,OAAO,CAAA,CAAE,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MA8B1D,MAAA,EAAQ,CAAC,OAAA,KACP,IAAA,CAAK,QAA4B,KAAA,EAAO,CAAA,WAAA,EAAc,OAAO,CAAA,OAAA,CAAS;AAAA,KAC1E;AA/cF,IAAA,IAAA,EAAA;AAwVI,IAAA,IAAI,CAAC,MAAA,CAAO,MAAA,EAAQ,MAAM,IAAI,MAAM,gCAAgC,CAAA;AACpE,IAAA,IAAI,CAAC,MAAA,CAAO,MAAA,CAAO,UAAA,CAAW,KAAK,CAAA,EAAG;AACpC,MAAA,MAAM,IAAI,KAAA;AAAA,QACR;AAAA,OACF;AAAA,IACF;AACA,IAAA,IAAA,CAAK,YACH,EAAA,GAAA,MAAA,CAAO,OAAA,KAAP,YAAkB,uCAAA,EAClB,OAAA,CAAQ,OAAO,EAAE,CAAA;AACnB,IAAA,IAAA,CAAK,OAAA,GAAU;AAAA,MACb,cAAA,EAAgB,kBAAA;AAAA,MAChB,aAAA,EAAe,CAAA,OAAA,EAAU,MAAA,CAAO,MAAM,CAAA;AAAA,KACxC;AAAA,EACF;AAAA,EAEA,MAAc,OAAA,CACZ,MAAA,EACA,IAAA,EACA,IAAA,EACY;AA3WhB,IAAA,IAAA,EAAA;AA4WI,IAAA,MAAM,GAAA,GAAM,MAAM,KAAA,CAAM,CAAA,EAAG,KAAK,OAAO,CAAA,EAAG,IAAI,CAAA,CAAA,EAAI;AAAA,MAChD,MAAA;AAAA,MACA,SAAS,IAAA,CAAK,OAAA;AAAA,MACd,MAAM,IAAA,KAAS,MAAA,GAAY,IAAA,CAAK,SAAA,CAAU,IAAI,CAAA,GAAI;AAAA,KACnD,CAAA;AAED,IAAA,MAAM,IAAA,GAAO,MAAM,GAAA,CAAI,IAAA,GAAO,KAAA,CAAM,OAAO,EAAC,CAAE,CAAA;AAE9C,IAAA,IAAI,CAAC,IAAI,EAAA,EAAI;AACX,MAAA,MAAM,WACH,EAAA,GAAA,IAAA,IAAA,IAAA,GAAA,MAAA,GAAA,IAAA,CAAc,OAAA,KAAd,IAAA,GAAA,EAAA,GAAyB,CAAA,2BAAA,EAA8B,IAAI,MAAM,CAAA,CAAA;AACpE,MAAA,MAAM,GAAA,GAAM,IAAI,KAAA,CAAM,CAAA,sBAAA,EAAyB,OAAO,CAAA,CAAE,CAAA;AACxD,MAAA,GAAA,CAAI,SAAS,GAAA,CAAI,MAAA;AACjB,MAAA,GAAA,CAAI,QAAA,GAAW,IAAA;AACf,MAAA,MAAM,GAAA;AAAA,IACR;AAEA,IAAA,OAAO,IAAA;AAAA,EACT;AAkFF;AAMA,IAAO,aAAA,GAAQ","file":"index.js","sourcesContent":["/**\r\n * SwiftProof JavaScript/TypeScript SDK\r\n *\r\n * Proof-of-work infrastructure for any industry where\r\n * something needs to be verified.\r\n *\r\n * npm install swiftproof\r\n */\r\n\r\n// ─────────────────────────────────────────────────────────────────────────────\r\n// PROOF EVENT — the core object every chain produces\r\n// Every confirmation in every industry maps to this same shape\r\n// ─────────────────────────────────────────────────────────────────────────────\r\n\r\n/**\r\n * A single verified proof event — one step in a chain of custody.\r\n *\r\n * Every proof event answers five universal questions:\r\n *   → who did it       = actor\r\n *   → what happened    = event\r\n *   → when it happened = confirmed_at\r\n *   → where it happened = location + lat + lng\r\n *   → evidence          = photo_url\r\n *\r\n * The hash field makes it tamper-proof:\r\n * each hash includes the previous one, so altering any\r\n * record breaks the entire chain and is caught by verify().\r\n */\r\nexport interface ProofEvent {\r\n  /** What happened — e.g. \"delivered\", \"inspected\", \"dispensed\", \"signed\" */\r\n  event: string;\r\n\r\n  /** Who did it — e.g. \"Rider — Emeka\", \"Pharmacist\", \"Inspector\" */\r\n  actor: string;\r\n\r\n  /** Whether this step has been confirmed yet */\r\n  confirmed: boolean;\r\n\r\n  /** Exact ISO timestamp of when the actor tapped confirm — null if not yet confirmed */\r\n  confirmed_at: string | null;\r\n\r\n  /** Human-readable location name (reverse geocoded) — e.g. \"Allen Avenue, Ikeja\" */\r\n  location: string | null;\r\n\r\n  /** GPS latitude at moment of confirmation */\r\n  lat: number | null;\r\n\r\n  /** GPS longitude at moment of confirmation */\r\n  lng: number | null;\r\n\r\n  /** Photo evidence URL (Cloudinary) — attached by actor at confirmation */\r\n  photo_url: string | null;\r\n\r\n  /**\r\n   * SHA-256 hash of this event chained to the previous one.\r\n   * If this hash doesn't match when verify() recomputes it,\r\n   * the chain is flagged as tampered.\r\n   */\r\n  hash: string | null;\r\n}\r\n\r\n// ─────────────────────────────────────────────────────────────────────────────\r\n// HANDOFF — a pending proof event (before confirmation)\r\n// ─────────────────────────────────────────────────────────────────────────────\r\n\r\n/**\r\n * A pending step in a chain — waiting for the actor to confirm.\r\n * Returned when you create a chain, before any confirmation happens.\r\n */\r\nexport interface PendingHandoff {\r\n  /** Unique handoff ID */\r\n  id: string;\r\n\r\n  /** What this step is — e.g. \"pickup\", \"delivered\" */\r\n  event: string;\r\n\r\n  /** Who needs to confirm this step */\r\n  actor: string;\r\n\r\n  /**\r\n   * The URL to send to the actor.\r\n   * When they open this link on any phone browser and tap confirm,\r\n   * their GPS is captured automatically and the proof event is recorded.\r\n   * No app download. No account. Just tap.\r\n   */\r\n  confirmation_url: string;\r\n\r\n  /** Raw token embedded in confirmation_url — for reference only */\r\n  confirmation_token: string;\r\n}\r\n\r\n// ─────────────────────────────────────────────────────────────────────────────\r\n// CHAIN — a complete chain of custody\r\n// ─────────────────────────────────────────────────────────────────────────────\r\n\r\n/**\r\n * A chain of custody — ties multiple proof events together\r\n * under one verifiable record.\r\n *\r\n * One chain per real-world event:\r\n *   - one food delivery\r\n *   - one pharmaceutical dispensing\r\n *   - one field agent visit\r\n *   - one court document service\r\n *   - one construction milestone\r\n */\r\nexport interface Chain {\r\n  /** Unique chain ID — reference this when calling getChain() or verify() */\r\n  chain_id: string;\r\n\r\n  /** Human-readable title — e.g. \"Order #1234 — Amaka Johnson\" */\r\n  title: string;\r\n\r\n  /**\r\n   * Current status of the chain:\r\n   * - \"open\"      → some steps still pending confirmation\r\n   * - \"completed\" → all steps confirmed, chain is sealed\r\n   */\r\n  status: 'open' | 'completed';\r\n\r\n  /**\r\n   * Public tracking URL — send this to whoever is waiting on the delivery.\r\n   * They open it in any browser. No account needed.\r\n   * Updates automatically every 15 seconds as steps are confirmed.\r\n   */\r\n  tracking_url: string;\r\n\r\n  /** Raw tracking token embedded in tracking_url */\r\n  tracking_token: string;\r\n\r\n  /**\r\n   * One per actor you defined when creating the chain.\r\n   * Send each confirmation_url to the relevant party:\r\n   *   chain.handoffs[0].confirmation_url → Kitchen\r\n   *   chain.handoffs[1].confirmation_url → Rider (pickup)\r\n   *   chain.handoffs[2].confirmation_url → Rider (delivery)\r\n   */\r\n  handoffs: PendingHandoff[];\r\n\r\n  /** ISO timestamp of when this chain was created */\r\n  created_at: string;\r\n}\r\n\r\n// ─────────────────────────────────────────────────────────────────────────────\r\n// CHAIN DETAIL — full audit trail (from getChain())\r\n// ─────────────────────────────────────────────────────────────────────────────\r\n\r\n/**\r\n * Full chain detail including the complete audit trail.\r\n * Returned by getChain() — use this to see the current state\r\n * of every step and all captured evidence.\r\n */\r\nexport interface ChainDetail {\r\n  chain_id: string;\r\n  title: string;\r\n  status: 'open' | 'completed';\r\n  metadata: Record<string, any>;\r\n  tracking_url: string;\r\n\r\n  /** SHA-256 hash of the entire completed chain — null until all steps confirmed */\r\n  integrity_hash: string | null;\r\n\r\n  /** Whether the chain has been tampered with */\r\n  tampered: boolean;\r\n\r\n  /**\r\n   * True only when:\r\n   *   - status === \"completed\" (all steps confirmed)\r\n   *   - tampered === false (no records altered)\r\n   */\r\n  verified: boolean;\r\n\r\n  created_at: string;\r\n\r\n  /**\r\n   * The complete audit trail — one ProofEvent per actor.\r\n   * Each event answers: who, what, when, where, evidence.\r\n   */\r\n  trail: (ProofEvent & {\r\n    id: string;\r\n    note: string | null;\r\n    /** confirmation_url is null once the step has been confirmed (link is spent) */\r\n    confirmation_url: string | null;\r\n  })[];\r\n}\r\n\r\n// ─────────────────────────────────────────────────────────────────────────────\r\n// VERIFICATION RESULT — from verify()\r\n// ─────────────────────────────────────────────────────────────────────────────\r\n\r\n/**\r\n * Result of calling verify() on a completed chain.\r\n *\r\n * Use this when:\r\n *   - A customer disputes a delivery\r\n *   - A regulator asks for proof of an event\r\n *   - An auditor needs to confirm a record wasn't altered\r\n *   - Anyone needs to know: did this actually happen?\r\n *\r\n * verified: true  → every step happened as recorded, nothing was altered\r\n * verified: false → chain is incomplete or tampered\r\n */\r\nexport interface VerificationResult {\r\n  chain_id: string;\r\n  title: string;\r\n  status: 'open' | 'completed';\r\n\r\n  /**\r\n   * The single most important field.\r\n   * true  = this chain is real, complete, and untampered\r\n   * false = incomplete or evidence of tampering\r\n   */\r\n  verified: boolean;\r\n\r\n  /** true if any record in the chain was altered after the fact */\r\n  tampered: boolean;\r\n\r\n  /** SHA-256 hash of the entire chain — for external audit records */\r\n  integrity_hash: string | null;\r\n\r\n  /** ISO timestamp of when the final step was confirmed */\r\n  completed_at: string | null;\r\n\r\n  /** Number of steps confirmed in this chain */\r\n  handoff_count: number;\r\n\r\n  /**\r\n   * The verified audit trail.\r\n   * Each entry is a cryptographically verified ProofEvent.\r\n   */\r\n  trail: (Pick<\r\n    ProofEvent,\r\n    'event' | 'actor' | 'confirmed_at' | 'location' | 'hash'\r\n  > & {\r\n    /** true if this specific step's hash verified correctly */\r\n    valid: boolean;\r\n  })[];\r\n}\r\n\r\n// ─────────────────────────────────────────────────────────────────────────────\r\n// INPUT TYPES — what you pass in\r\n// ─────────────────────────────────────────────────────────────────────────────\r\n\r\n/**\r\n * One actor in a chain — defines a step that needs to be confirmed.\r\n *\r\n * Use plain language that makes sense for your industry:\r\n *   Food:         { event: \"packed\",    actor: \"Kitchen\" }\r\n *   Pharmacy:     { event: \"dispensed\", actor: \"Pharmacist\" }\r\n *   Banking:      { event: \"dispatched\",actor: \"Branch Officer\" }\r\n *   Construction: { event: \"milestone_complete\", actor: \"Contractor\" }\r\n *   Legal:        { event: \"served\",    actor: \"Process Server\" }\r\n *   Insurance:    { event: \"assessed\",  actor: \"Claims Assessor\" }\r\n */\r\nexport interface ProofActor {\r\n  /** What happens at this step — use plain language from your domain */\r\n  event: string;\r\n\r\n  /** Who is responsible for confirming this step */\r\n  actor: string;\r\n\r\n  /** Optional internal note about this step */\r\n  note?: string;\r\n}\r\n\r\n/** Input for creating a new chain of custody */\r\nexport interface CreateChainInput {\r\n  /**\r\n   * Human-readable title for this chain.\r\n   * Include enough context to identify it later:\r\n   *   \"Order #1234 — Amaka Johnson\"\r\n   *   \"Prescription #5567 — Mrs Obi\"\r\n   *   \"Site inspection — Plot 14, Lekki\"\r\n   */\r\n  title: string;\r\n\r\n  /**\r\n   * Any extra data you want to store with this chain.\r\n   * Does not affect the proof logic — purely for your reference.\r\n   */\r\n  metadata?: Record<string, any>;\r\n\r\n  /**\r\n   * The steps that need to be confirmed, in order.\r\n   * Each one gets its own confirmation_url.\r\n   * Steps are confirmed independently — order is tracked by timestamp.\r\n   */\r\n  actors: ProofActor[];\r\n}\r\n\r\n// ─────────────────────────────────────────────────────────────────────────────\r\n// SDK CLIENT\r\n// ─────────────────────────────────────────────────────────────────────────────\r\n\r\nexport interface SwiftProofConfig {\r\n  /** Your API key — starts with sp_live_ or sp_test_ */\r\n  apiKey: string;\r\n\r\n  /**\r\n   * API base URL.\r\n   * Defaults to https://swiftproof-infra.onrender.com\r\n   * Override for local development: http://localhost:4000\r\n   */\r\n  baseUrl?: string;\r\n}\r\n\r\n/**\r\n * SwiftProof SDK\r\n *\r\n * Proof-of-work infrastructure. One API call captures tamper-proof\r\n * evidence of any event in any industry.\r\n *\r\n * @example\r\n * ```typescript\r\n * const sp = new SwiftProof({ apiKey: 'sp_live_xxx' });\r\n *\r\n * const chain = await sp.chains.create({\r\n *   title: 'Order #1234 — Amaka Johnson',\r\n *   actors: [\r\n *     { event: 'packed',    actor: 'Kitchen' },\r\n *     { event: 'pickup',    actor: 'Rider — Emeka' },\r\n *     { event: 'delivered', actor: 'Rider — Emeka' },\r\n *   ],\r\n * });\r\n *\r\n * // Send these to the relevant parties\r\n * chain.handoffs[0].confirmation_url  // → Kitchen\r\n * chain.handoffs[1].confirmation_url  // → Rider (pickup)\r\n * chain.handoffs[2].confirmation_url  // → Rider (delivery)\r\n *\r\n * // Send this to the customer\r\n * chain.tracking_url\r\n *\r\n * // Later — verify everything happened\r\n * const proof = await sp.chains.verify(chain.chain_id);\r\n * proof.verified  // true = happened, untampered\r\n * proof.tampered  // false = nothing altered\r\n * ```\r\n */\r\nexport class SwiftProof {\r\n  private readonly baseUrl: string;\r\n  private readonly headers: Record<string, string>;\r\n\r\n  constructor(config: SwiftProofConfig) {\r\n    if (!config.apiKey) throw new Error('SwiftProof: apiKey is required');\r\n    if (!config.apiKey.startsWith('sp_')) {\r\n      throw new Error(\r\n        'SwiftProof: apiKey must start with sp_live_ or sp_test_',\r\n      );\r\n    }\r\n    this.baseUrl = (\r\n      config.baseUrl ?? 'https://swiftproof-infra.onrender.com'\r\n    ).replace(/\\/$/, '');\r\n    this.headers = {\r\n      'Content-Type': 'application/json',\r\n      Authorization: `Bearer ${config.apiKey}`,\r\n    };\r\n  }\r\n\r\n  private async request<T>(\r\n    method: string,\r\n    path: string,\r\n    body?: unknown,\r\n  ): Promise<T> {\r\n    const res = await fetch(`${this.baseUrl}${path}`, {\r\n      method,\r\n      headers: this.headers,\r\n      body: body !== undefined ? JSON.stringify(body) : undefined,\r\n    });\r\n\r\n    const data = await res.json().catch(() => ({}));\r\n\r\n    if (!res.ok) {\r\n      const message =\r\n        (data as any)?.message ?? `Request failed with status ${res.status}`;\r\n      const err = new Error(`SwiftProof API error: ${message}`) as any;\r\n      err.status = res.status;\r\n      err.response = data;\r\n      throw err;\r\n    }\r\n\r\n    return data as T;\r\n  }\r\n\r\n  /** All chain of custody operations */\r\n  readonly chains = {\r\n    /**\r\n     * Create a new chain of custody.\r\n     *\r\n     * Call this when a real-world handoff event begins:\r\n     * an order is placed, a delivery is dispatched,\r\n     * an inspection is scheduled, a document is to be served.\r\n     *\r\n     * Returns confirmation URLs for each actor and a\r\n     * tracking URL for the end recipient.\r\n     *\r\n     * @example\r\n     * ```typescript\r\n     * const chain = await sp.chains.create({\r\n     *   title: 'Order #1234',\r\n     *   actors: [\r\n     *     { event: 'packed',    actor: 'Kitchen' },\r\n     *     { event: 'delivered', actor: 'Rider' },\r\n     *   ],\r\n     * });\r\n     *\r\n     * // Kitchen taps this link → GPS captured → \"packed\" confirmed\r\n     * chain.handoffs[0].confirmation_url\r\n     *\r\n     * // Customer opens this → sees live status timeline\r\n     * chain.tracking_url\r\n     * ```\r\n     */\r\n    create: (input: CreateChainInput): Promise<Chain> =>\r\n      this.request<Chain>('POST', '/v1/chains', input),\r\n\r\n    /**\r\n     * Get the full audit trail for a chain.\r\n     *\r\n     * Shows every step — confirmed or pending —\r\n     * with all captured evidence: GPS, timestamp, photo, hash.\r\n     *\r\n     * @example\r\n     * ```typescript\r\n     * const detail = await sp.chains.get('sp_ch_abc123');\r\n     * detail.trail.forEach(step => {\r\n     *   console.log(step.event, step.confirmed_at, step.location);\r\n     * });\r\n     * ```\r\n     */\r\n    get: (chainId: string): Promise<ChainDetail> =>\r\n      this.request<ChainDetail>('GET', `/v1/chains/${chainId}`),\r\n\r\n    /**\r\n     * Verify a completed chain of custody.\r\n     *\r\n     * Recomputes every hash in the chain and confirms nothing\r\n     * was altered after the fact.\r\n     *\r\n     * Use this when:\r\n     * - A customer disputes a delivery\r\n     * - A regulator asks for proof\r\n     * - An auditor needs to confirm records are untampered\r\n     *\r\n     * @returns VerificationResult with verified: true if chain is\r\n     * complete and cryptographically intact\r\n     *\r\n     * @example\r\n     * ```typescript\r\n     * const proof = await sp.chains.verify('sp_ch_abc123');\r\n     *\r\n     * if (proof.verified) {\r\n     *   // Chain is complete and untampered\r\n     *   // Show proof.trail as evidence\r\n     * } else if (proof.tampered) {\r\n     *   // Records were altered — do not use as evidence\r\n     * } else {\r\n     *   // Chain not yet complete — some steps pending\r\n     * }\r\n     * ```\r\n     */\r\n    verify: (chainId: string): Promise<VerificationResult> =>\r\n      this.request<VerificationResult>('GET', `/v1/chains/${chainId}/verify`),\r\n  };\r\n}\r\n\r\n// ─────────────────────────────────────────────────────────────────────────────\r\n// DEFAULT EXPORT\r\n// ─────────────────────────────────────────────────────────────────────────────\r\n\r\nexport default SwiftProof;\r\n"]}

package/dist/index.mjs

@@ -0,0 +1,114 @@
+// src/index.ts
+var SwiftProof = class {
+  constructor(config) {
+    /** All chain of custody operations */
+    this.chains = {
+      /**
+       * Create a new chain of custody.
+       *
+       * Call this when a real-world handoff event begins:
+       * an order is placed, a delivery is dispatched,
+       * an inspection is scheduled, a document is to be served.
+       *
+       * Returns confirmation URLs for each actor and a
+       * tracking URL for the end recipient.
+       *
+       * @example
+       * ```typescript
+       * const chain = await sp.chains.create({
+       *   title: 'Order #1234',
+       *   actors: [
+       *     { event: 'packed',    actor: 'Kitchen' },
+       *     { event: 'delivered', actor: 'Rider' },
+       *   ],
+       * });
+       *
+       * // Kitchen taps this link → GPS captured → "packed" confirmed
+       * chain.handoffs[0].confirmation_url
+       *
+       * // Customer opens this → sees live status timeline
+       * chain.tracking_url
+       * ```
+       */
+      create: (input) => this.request("POST", "/v1/chains", input),
+      /**
+       * Get the full audit trail for a chain.
+       *
+       * Shows every step — confirmed or pending —
+       * with all captured evidence: GPS, timestamp, photo, hash.
+       *
+       * @example
+       * ```typescript
+       * const detail = await sp.chains.get('sp_ch_abc123');
+       * detail.trail.forEach(step => {
+       *   console.log(step.event, step.confirmed_at, step.location);
+       * });
+       * ```
+       */
+      get: (chainId) => this.request("GET", `/v1/chains/${chainId}`),
+      /**
+       * Verify a completed chain of custody.
+       *
+       * Recomputes every hash in the chain and confirms nothing
+       * was altered after the fact.
+       *
+       * Use this when:
+       * - A customer disputes a delivery
+       * - A regulator asks for proof
+       * - An auditor needs to confirm records are untampered
+       *
+       * @returns VerificationResult with verified: true if chain is
+       * complete and cryptographically intact
+       *
+       * @example
+       * ```typescript
+       * const proof = await sp.chains.verify('sp_ch_abc123');
+       *
+       * if (proof.verified) {
+       *   // Chain is complete and untampered
+       *   // Show proof.trail as evidence
+       * } else if (proof.tampered) {
+       *   // Records were altered — do not use as evidence
+       * } else {
+       *   // Chain not yet complete — some steps pending
+       * }
+       * ```
+       */
+      verify: (chainId) => this.request("GET", `/v1/chains/${chainId}/verify`)
+    };
+    var _a;
+    if (!config.apiKey) throw new Error("SwiftProof: apiKey is required");
+    if (!config.apiKey.startsWith("sp_")) {
+      throw new Error(
+        "SwiftProof: apiKey must start with sp_live_ or sp_test_"
+      );
+    }
+    this.baseUrl = ((_a = config.baseUrl) != null ? _a : "https://swiftproof-infra.onrender.com").replace(/\/$/, "");
+    this.headers = {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${config.apiKey}`
+    };
+  }
+  async request(method, path, body) {
+    var _a;
+    const res = await fetch(`${this.baseUrl}${path}`, {
+      method,
+      headers: this.headers,
+      body: body !== void 0 ? JSON.stringify(body) : void 0
+    });
+    const data = await res.json().catch(() => ({}));
+    if (!res.ok) {
+      const message = (_a = data == null ? void 0 : data.message) != null ? _a : `Request failed with status ${res.status}`;
+      const err = new Error(`SwiftProof API error: ${message}`);
+      err.status = res.status;
+      err.response = data;
+      throw err;
+    }
+    return data;
+  }
+};
+var index_default = SwiftProof;
+
+export { SwiftProof, index_default as default };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";AAmVO,IAAM,aAAN,MAAiB;AAAA,EAItB,YAAY,MAAA,EAA0B;AA0CtC;AAAA,IAAA,IAAA,CAAS,MAAA,GAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MA4BhB,QAAQ,CAAC,KAAA,KACP,KAAK,OAAA,CAAe,MAAA,EAAQ,cAAc,KAAK,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAgBjD,GAAA,EAAK,CAAC,OAAA,KACJ,IAAA,CAAK,QAAqB,KAAA,EAAO,CAAA,WAAA,EAAc,OAAO,CAAA,CAAE,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MA8B1D,MAAA,EAAQ,CAAC,OAAA,KACP,IAAA,CAAK,QAA4B,KAAA,EAAO,CAAA,WAAA,EAAc,OAAO,CAAA,OAAA,CAAS;AAAA,KAC1E;AA/cF,IAAA,IAAA,EAAA;AAwVI,IAAA,IAAI,CAAC,MAAA,CAAO,MAAA,EAAQ,MAAM,IAAI,MAAM,gCAAgC,CAAA;AACpE,IAAA,IAAI,CAAC,MAAA,CAAO,MAAA,CAAO,UAAA,CAAW,KAAK,CAAA,EAAG;AACpC,MAAA,MAAM,IAAI,KAAA;AAAA,QACR;AAAA,OACF;AAAA,IACF;AACA,IAAA,IAAA,CAAK,YACH,EAAA,GAAA,MAAA,CAAO,OAAA,KAAP,YAAkB,uCAAA,EAClB,OAAA,CAAQ,OAAO,EAAE,CAAA;AACnB,IAAA,IAAA,CAAK,OAAA,GAAU;AAAA,MACb,cAAA,EAAgB,kBAAA;AAAA,MAChB,aAAA,EAAe,CAAA,OAAA,EAAU,MAAA,CAAO,MAAM,CAAA;AAAA,KACxC;AAAA,EACF;AAAA,EAEA,MAAc,OAAA,CACZ,MAAA,EACA,IAAA,EACA,IAAA,EACY;AA3WhB,IAAA,IAAA,EAAA;AA4WI,IAAA,MAAM,GAAA,GAAM,MAAM,KAAA,CAAM,CAAA,EAAG,KAAK,OAAO,CAAA,EAAG,IAAI,CAAA,CAAA,EAAI;AAAA,MAChD,MAAA;AAAA,MACA,SAAS,IAAA,CAAK,OAAA;AAAA,MACd,MAAM,IAAA,KAAS,MAAA,GAAY,IAAA,CAAK,SAAA,CAAU,IAAI,CAAA,GAAI;AAAA,KACnD,CAAA;AAED,IAAA,MAAM,IAAA,GAAO,MAAM,GAAA,CAAI,IAAA,GAAO,KAAA,CAAM,OAAO,EAAC,CAAE,CAAA;AAE9C,IAAA,IAAI,CAAC,IAAI,EAAA,EAAI;AACX,MAAA,MAAM,WACH,EAAA,GAAA,IAAA,IAAA,IAAA,GAAA,MAAA,GAAA,IAAA,CAAc,OAAA,KAAd,IAAA,GAAA,EAAA,GAAyB,CAAA,2BAAA,EAA8B,IAAI,MAAM,CAAA,CAAA;AACpE,MAAA,MAAM,GAAA,GAAM,IAAI,KAAA,CAAM,CAAA,sBAAA,EAAyB,OAAO,CAAA,CAAE,CAAA;AACxD,MAAA,GAAA,CAAI,SAAS,GAAA,CAAI,MAAA;AACjB,MAAA,GAAA,CAAI,QAAA,GAAW,IAAA;AACf,MAAA,MAAM,GAAA;AAAA,IACR;AAEA,IAAA,OAAO,IAAA;AAAA,EACT;AAkFF;AAMA,IAAO,aAAA,GAAQ","file":"index.mjs","sourcesContent":["/**\r\n * SwiftProof JavaScript/TypeScript SDK\r\n *\r\n * Proof-of-work infrastructure for any industry where\r\n * something needs to be verified.\r\n *\r\n * npm install swiftproof\r\n */\r\n\r\n// ─────────────────────────────────────────────────────────────────────────────\r\n// PROOF EVENT — the core object every chain produces\r\n// Every confirmation in every industry maps to this same shape\r\n// ─────────────────────────────────────────────────────────────────────────────\r\n\r\n/**\r\n * A single verified proof event — one step in a chain of custody.\r\n *\r\n * Every proof event answers five universal questions:\r\n *   → who did it       = actor\r\n *   → what happened    = event\r\n *   → when it happened = confirmed_at\r\n *   → where it happened = location + lat + lng\r\n *   → evidence          = photo_url\r\n *\r\n * The hash field makes it tamper-proof:\r\n * each hash includes the previous one, so altering any\r\n * record breaks the entire chain and is caught by verify().\r\n */\r\nexport interface ProofEvent {\r\n  /** What happened — e.g. \"delivered\", \"inspected\", \"dispensed\", \"signed\" */\r\n  event: string;\r\n\r\n  /** Who did it — e.g. \"Rider — Emeka\", \"Pharmacist\", \"Inspector\" */\r\n  actor: string;\r\n\r\n  /** Whether this step has been confirmed yet */\r\n  confirmed: boolean;\r\n\r\n  /** Exact ISO timestamp of when the actor tapped confirm — null if not yet confirmed */\r\n  confirmed_at: string | null;\r\n\r\n  /** Human-readable location name (reverse geocoded) — e.g. \"Allen Avenue, Ikeja\" */\r\n  location: string | null;\r\n\r\n  /** GPS latitude at moment of confirmation */\r\n  lat: number | null;\r\n\r\n  /** GPS longitude at moment of confirmation */\r\n  lng: number | null;\r\n\r\n  /** Photo evidence URL (Cloudinary) — attached by actor at confirmation */\r\n  photo_url: string | null;\r\n\r\n  /**\r\n   * SHA-256 hash of this event chained to the previous one.\r\n   * If this hash doesn't match when verify() recomputes it,\r\n   * the chain is flagged as tampered.\r\n   */\r\n  hash: string | null;\r\n}\r\n\r\n// ─────────────────────────────────────────────────────────────────────────────\r\n// HANDOFF — a pending proof event (before confirmation)\r\n// ─────────────────────────────────────────────────────────────────────────────\r\n\r\n/**\r\n * A pending step in a chain — waiting for the actor to confirm.\r\n * Returned when you create a chain, before any confirmation happens.\r\n */\r\nexport interface PendingHandoff {\r\n  /** Unique handoff ID */\r\n  id: string;\r\n\r\n  /** What this step is — e.g. \"pickup\", \"delivered\" */\r\n  event: string;\r\n\r\n  /** Who needs to confirm this step */\r\n  actor: string;\r\n\r\n  /**\r\n   * The URL to send to the actor.\r\n   * When they open this link on any phone browser and tap confirm,\r\n   * their GPS is captured automatically and the proof event is recorded.\r\n   * No app download. No account. Just tap.\r\n   */\r\n  confirmation_url: string;\r\n\r\n  /** Raw token embedded in confirmation_url — for reference only */\r\n  confirmation_token: string;\r\n}\r\n\r\n// ─────────────────────────────────────────────────────────────────────────────\r\n// CHAIN — a complete chain of custody\r\n// ─────────────────────────────────────────────────────────────────────────────\r\n\r\n/**\r\n * A chain of custody — ties multiple proof events together\r\n * under one verifiable record.\r\n *\r\n * One chain per real-world event:\r\n *   - one food delivery\r\n *   - one pharmaceutical dispensing\r\n *   - one field agent visit\r\n *   - one court document service\r\n *   - one construction milestone\r\n */\r\nexport interface Chain {\r\n  /** Unique chain ID — reference this when calling getChain() or verify() */\r\n  chain_id: string;\r\n\r\n  /** Human-readable title — e.g. \"Order #1234 — Amaka Johnson\" */\r\n  title: string;\r\n\r\n  /**\r\n   * Current status of the chain:\r\n   * - \"open\"      → some steps still pending confirmation\r\n   * - \"completed\" → all steps confirmed, chain is sealed\r\n   */\r\n  status: 'open' | 'completed';\r\n\r\n  /**\r\n   * Public tracking URL — send this to whoever is waiting on the delivery.\r\n   * They open it in any browser. No account needed.\r\n   * Updates automatically every 15 seconds as steps are confirmed.\r\n   */\r\n  tracking_url: string;\r\n\r\n  /** Raw tracking token embedded in tracking_url */\r\n  tracking_token: string;\r\n\r\n  /**\r\n   * One per actor you defined when creating the chain.\r\n   * Send each confirmation_url to the relevant party:\r\n   *   chain.handoffs[0].confirmation_url → Kitchen\r\n   *   chain.handoffs[1].confirmation_url → Rider (pickup)\r\n   *   chain.handoffs[2].confirmation_url → Rider (delivery)\r\n   */\r\n  handoffs: PendingHandoff[];\r\n\r\n  /** ISO timestamp of when this chain was created */\r\n  created_at: string;\r\n}\r\n\r\n// ─────────────────────────────────────────────────────────────────────────────\r\n// CHAIN DETAIL — full audit trail (from getChain())\r\n// ─────────────────────────────────────────────────────────────────────────────\r\n\r\n/**\r\n * Full chain detail including the complete audit trail.\r\n * Returned by getChain() — use this to see the current state\r\n * of every step and all captured evidence.\r\n */\r\nexport interface ChainDetail {\r\n  chain_id: string;\r\n  title: string;\r\n  status: 'open' | 'completed';\r\n  metadata: Record<string, any>;\r\n  tracking_url: string;\r\n\r\n  /** SHA-256 hash of the entire completed chain — null until all steps confirmed */\r\n  integrity_hash: string | null;\r\n\r\n  /** Whether the chain has been tampered with */\r\n  tampered: boolean;\r\n\r\n  /**\r\n   * True only when:\r\n   *   - status === \"completed\" (all steps confirmed)\r\n   *   - tampered === false (no records altered)\r\n   */\r\n  verified: boolean;\r\n\r\n  created_at: string;\r\n\r\n  /**\r\n   * The complete audit trail — one ProofEvent per actor.\r\n   * Each event answers: who, what, when, where, evidence.\r\n   */\r\n  trail: (ProofEvent & {\r\n    id: string;\r\n    note: string | null;\r\n    /** confirmation_url is null once the step has been confirmed (link is spent) */\r\n    confirmation_url: string | null;\r\n  })[];\r\n}\r\n\r\n// ─────────────────────────────────────────────────────────────────────────────\r\n// VERIFICATION RESULT — from verify()\r\n// ─────────────────────────────────────────────────────────────────────────────\r\n\r\n/**\r\n * Result of calling verify() on a completed chain.\r\n *\r\n * Use this when:\r\n *   - A customer disputes a delivery\r\n *   - A regulator asks for proof of an event\r\n *   - An auditor needs to confirm a record wasn't altered\r\n *   - Anyone needs to know: did this actually happen?\r\n *\r\n * verified: true  → every step happened as recorded, nothing was altered\r\n * verified: false → chain is incomplete or tampered\r\n */\r\nexport interface VerificationResult {\r\n  chain_id: string;\r\n  title: string;\r\n  status: 'open' | 'completed';\r\n\r\n  /**\r\n   * The single most important field.\r\n   * true  = this chain is real, complete, and untampered\r\n   * false = incomplete or evidence of tampering\r\n   */\r\n  verified: boolean;\r\n\r\n  /** true if any record in the chain was altered after the fact */\r\n  tampered: boolean;\r\n\r\n  /** SHA-256 hash of the entire chain — for external audit records */\r\n  integrity_hash: string | null;\r\n\r\n  /** ISO timestamp of when the final step was confirmed */\r\n  completed_at: string | null;\r\n\r\n  /** Number of steps confirmed in this chain */\r\n  handoff_count: number;\r\n\r\n  /**\r\n   * The verified audit trail.\r\n   * Each entry is a cryptographically verified ProofEvent.\r\n   */\r\n  trail: (Pick<\r\n    ProofEvent,\r\n    'event' | 'actor' | 'confirmed_at' | 'location' | 'hash'\r\n  > & {\r\n    /** true if this specific step's hash verified correctly */\r\n    valid: boolean;\r\n  })[];\r\n}\r\n\r\n// ─────────────────────────────────────────────────────────────────────────────\r\n// INPUT TYPES — what you pass in\r\n// ─────────────────────────────────────────────────────────────────────────────\r\n\r\n/**\r\n * One actor in a chain — defines a step that needs to be confirmed.\r\n *\r\n * Use plain language that makes sense for your industry:\r\n *   Food:         { event: \"packed\",    actor: \"Kitchen\" }\r\n *   Pharmacy:     { event: \"dispensed\", actor: \"Pharmacist\" }\r\n *   Banking:      { event: \"dispatched\",actor: \"Branch Officer\" }\r\n *   Construction: { event: \"milestone_complete\", actor: \"Contractor\" }\r\n *   Legal:        { event: \"served\",    actor: \"Process Server\" }\r\n *   Insurance:    { event: \"assessed\",  actor: \"Claims Assessor\" }\r\n */\r\nexport interface ProofActor {\r\n  /** What happens at this step — use plain language from your domain */\r\n  event: string;\r\n\r\n  /** Who is responsible for confirming this step */\r\n  actor: string;\r\n\r\n  /** Optional internal note about this step */\r\n  note?: string;\r\n}\r\n\r\n/** Input for creating a new chain of custody */\r\nexport interface CreateChainInput {\r\n  /**\r\n   * Human-readable title for this chain.\r\n   * Include enough context to identify it later:\r\n   *   \"Order #1234 — Amaka Johnson\"\r\n   *   \"Prescription #5567 — Mrs Obi\"\r\n   *   \"Site inspection — Plot 14, Lekki\"\r\n   */\r\n  title: string;\r\n\r\n  /**\r\n   * Any extra data you want to store with this chain.\r\n   * Does not affect the proof logic — purely for your reference.\r\n   */\r\n  metadata?: Record<string, any>;\r\n\r\n  /**\r\n   * The steps that need to be confirmed, in order.\r\n   * Each one gets its own confirmation_url.\r\n   * Steps are confirmed independently — order is tracked by timestamp.\r\n   */\r\n  actors: ProofActor[];\r\n}\r\n\r\n// ─────────────────────────────────────────────────────────────────────────────\r\n// SDK CLIENT\r\n// ─────────────────────────────────────────────────────────────────────────────\r\n\r\nexport interface SwiftProofConfig {\r\n  /** Your API key — starts with sp_live_ or sp_test_ */\r\n  apiKey: string;\r\n\r\n  /**\r\n   * API base URL.\r\n   * Defaults to https://swiftproof-infra.onrender.com\r\n   * Override for local development: http://localhost:4000\r\n   */\r\n  baseUrl?: string;\r\n}\r\n\r\n/**\r\n * SwiftProof SDK\r\n *\r\n * Proof-of-work infrastructure. One API call captures tamper-proof\r\n * evidence of any event in any industry.\r\n *\r\n * @example\r\n * ```typescript\r\n * const sp = new SwiftProof({ apiKey: 'sp_live_xxx' });\r\n *\r\n * const chain = await sp.chains.create({\r\n *   title: 'Order #1234 — Amaka Johnson',\r\n *   actors: [\r\n *     { event: 'packed',    actor: 'Kitchen' },\r\n *     { event: 'pickup',    actor: 'Rider — Emeka' },\r\n *     { event: 'delivered', actor: 'Rider — Emeka' },\r\n *   ],\r\n * });\r\n *\r\n * // Send these to the relevant parties\r\n * chain.handoffs[0].confirmation_url  // → Kitchen\r\n * chain.handoffs[1].confirmation_url  // → Rider (pickup)\r\n * chain.handoffs[2].confirmation_url  // → Rider (delivery)\r\n *\r\n * // Send this to the customer\r\n * chain.tracking_url\r\n *\r\n * // Later — verify everything happened\r\n * const proof = await sp.chains.verify(chain.chain_id);\r\n * proof.verified  // true = happened, untampered\r\n * proof.tampered  // false = nothing altered\r\n * ```\r\n */\r\nexport class SwiftProof {\r\n  private readonly baseUrl: string;\r\n  private readonly headers: Record<string, string>;\r\n\r\n  constructor(config: SwiftProofConfig) {\r\n    if (!config.apiKey) throw new Error('SwiftProof: apiKey is required');\r\n    if (!config.apiKey.startsWith('sp_')) {\r\n      throw new Error(\r\n        'SwiftProof: apiKey must start with sp_live_ or sp_test_',\r\n      );\r\n    }\r\n    this.baseUrl = (\r\n      config.baseUrl ?? 'https://swiftproof-infra.onrender.com'\r\n    ).replace(/\\/$/, '');\r\n    this.headers = {\r\n      'Content-Type': 'application/json',\r\n      Authorization: `Bearer ${config.apiKey}`,\r\n    };\r\n  }\r\n\r\n  private async request<T>(\r\n    method: string,\r\n    path: string,\r\n    body?: unknown,\r\n  ): Promise<T> {\r\n    const res = await fetch(`${this.baseUrl}${path}`, {\r\n      method,\r\n      headers: this.headers,\r\n      body: body !== undefined ? JSON.stringify(body) : undefined,\r\n    });\r\n\r\n    const data = await res.json().catch(() => ({}));\r\n\r\n    if (!res.ok) {\r\n      const message =\r\n        (data as any)?.message ?? `Request failed with status ${res.status}`;\r\n      const err = new Error(`SwiftProof API error: ${message}`) as any;\r\n      err.status = res.status;\r\n      err.response = data;\r\n      throw err;\r\n    }\r\n\r\n    return data as T;\r\n  }\r\n\r\n  /** All chain of custody operations */\r\n  readonly chains = {\r\n    /**\r\n     * Create a new chain of custody.\r\n     *\r\n     * Call this when a real-world handoff event begins:\r\n     * an order is placed, a delivery is dispatched,\r\n     * an inspection is scheduled, a document is to be served.\r\n     *\r\n     * Returns confirmation URLs for each actor and a\r\n     * tracking URL for the end recipient.\r\n     *\r\n     * @example\r\n     * ```typescript\r\n     * const chain = await sp.chains.create({\r\n     *   title: 'Order #1234',\r\n     *   actors: [\r\n     *     { event: 'packed',    actor: 'Kitchen' },\r\n     *     { event: 'delivered', actor: 'Rider' },\r\n     *   ],\r\n     * });\r\n     *\r\n     * // Kitchen taps this link → GPS captured → \"packed\" confirmed\r\n     * chain.handoffs[0].confirmation_url\r\n     *\r\n     * // Customer opens this → sees live status timeline\r\n     * chain.tracking_url\r\n     * ```\r\n     */\r\n    create: (input: CreateChainInput): Promise<Chain> =>\r\n      this.request<Chain>('POST', '/v1/chains', input),\r\n\r\n    /**\r\n     * Get the full audit trail for a chain.\r\n     *\r\n     * Shows every step — confirmed or pending —\r\n     * with all captured evidence: GPS, timestamp, photo, hash.\r\n     *\r\n     * @example\r\n     * ```typescript\r\n     * const detail = await sp.chains.get('sp_ch_abc123');\r\n     * detail.trail.forEach(step => {\r\n     *   console.log(step.event, step.confirmed_at, step.location);\r\n     * });\r\n     * ```\r\n     */\r\n    get: (chainId: string): Promise<ChainDetail> =>\r\n      this.request<ChainDetail>('GET', `/v1/chains/${chainId}`),\r\n\r\n    /**\r\n     * Verify a completed chain of custody.\r\n     *\r\n     * Recomputes every hash in the chain and confirms nothing\r\n     * was altered after the fact.\r\n     *\r\n     * Use this when:\r\n     * - A customer disputes a delivery\r\n     * - A regulator asks for proof\r\n     * - An auditor needs to confirm records are untampered\r\n     *\r\n     * @returns VerificationResult with verified: true if chain is\r\n     * complete and cryptographically intact\r\n     *\r\n     * @example\r\n     * ```typescript\r\n     * const proof = await sp.chains.verify('sp_ch_abc123');\r\n     *\r\n     * if (proof.verified) {\r\n     *   // Chain is complete and untampered\r\n     *   // Show proof.trail as evidence\r\n     * } else if (proof.tampered) {\r\n     *   // Records were altered — do not use as evidence\r\n     * } else {\r\n     *   // Chain not yet complete — some steps pending\r\n     * }\r\n     * ```\r\n     */\r\n    verify: (chainId: string): Promise<VerificationResult> =>\r\n      this.request<VerificationResult>('GET', `/v1/chains/${chainId}/verify`),\r\n  };\r\n}\r\n\r\n// ─────────────────────────────────────────────────────────────────────────────\r\n// DEFAULT EXPORT\r\n// ─────────────────────────────────────────────────────────────────────────────\r\n\r\nexport default SwiftProof;\r\n"]}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "swiftproof",
+  "version": "0.1.0",
+  "description": "SwiftProof chain of custody SDK — plug and play proof infrastructure",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch"
+  },
+  "keywords": [
+    "chain-of-custody",
+    "proof",
+    "logistics",
+    "delivery",
+    "audit-trail"
+  ],
+  "license": "MIT"
+}

package/src/index.js

@@ -0,0 +1,130 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SwiftProof = void 0;
+const axios_1 = __importDefault(require("axios"));
+__exportStar(require("./types"), exports);
+class SwiftProof {
+    constructor(config) {
+        var _a;
+        // ── Chains ────────────────────────────────────────────────
+        this.chains = {
+            /**
+             * Create a new chain of custody
+             *
+             * @example
+             * const chain = await sp.chains.create({
+             *   title: 'Order #1234',
+             *   actors: [
+             *     { event: 'packed', actor: 'Kitchen' },
+             *     { event: 'pickup', actor: 'Rider' },
+             *     { event: 'delivered', actor: 'Rider' },
+             *   ]
+             * });
+             */
+            create: async (params) => {
+                const res = await this.client.post('/v1/chains', params);
+                return res.data;
+            },
+            /**
+             * Get full audit trail for a chain
+             *
+             * @example
+             * const chain = await sp.chains.get('sp_ch_abc123');
+             */
+            get: async (chainId) => {
+                const res = await this.client.get(`/v1/chains/${chainId}`);
+                return res.data;
+            },
+            /**
+             * Verify chain integrity — use for dispute resolution
+             *
+             * @example
+             * const result = await sp.chains.verify('sp_ch_abc123');
+             * if (result.verified) {
+             *   // delivery is proven — no dispute possible
+             * }
+             */
+            verify: async (chainId) => {
+                const res = await this.client.get(`/v1/chains/${chainId}/verify`);
+                return res.data;
+            },
+        };
+        // ── Handoffs ──────────────────────────────────────────────
+        this.handoffs = {
+            /**
+             * Confirm a handoff using an actor token
+             * This is called when kitchen, rider, or any actor taps their link
+             *
+             * @example
+             * await sp.handoffs.confirm('actor_token_here', {
+             *   lat: 6.5244,
+             *   lng: 3.3792,
+             *   note: 'Packed and sealed'
+             * });
+             */
+            confirm: async (actorToken, params) => {
+                const res = await this.client.post(`/confirm/${actorToken}`, params !== null && params !== void 0 ? params : {});
+                return res.data;
+            },
+        };
+        // ── Tracking ──────────────────────────────────────────────
+        this.tracking = {
+            /**
+             * Get public tracking data — no auth required
+             * Use this to show customers where their order is
+             *
+             * @example
+             * const tracking = await sp.tracking.get('tracking_token_here');
+             * console.log(tracking.current_location);
+             */
+            get: async (trackingToken) => {
+                // Tracking is public — use plain axios not authenticated client
+                const res = await axios_1.default.get(`${this.baseUrl}/track/${trackingToken}`);
+                return res.data;
+            },
+        };
+        if (!config.apiKey)
+            throw new Error('SwiftProof: apiKey is required');
+        if (!config.apiKey.startsWith('sp_')) {
+            throw new Error('SwiftProof: invalid apiKey format. Must start with sp_');
+        }
+        this.baseUrl = (_a = config.baseUrl) !== null && _a !== void 0 ? _a : 'https://api.swiftproof.io';
+        this.client = axios_1.default.create({
+            baseURL: this.baseUrl,
+            headers: {
+                Authorization: `Bearer ${config.apiKey}`,
+                'Content-Type': 'application/json',
+                'User-Agent': 'swiftproof-js/0.1.0',
+            },
+            timeout: 30000,
+        });
+        // Response interceptor — clean error messages
+        this.client.interceptors.response.use((res) => res, (err) => {
+            var _a, _b, _c, _d, _e;
+            const message = (_d = (_c = (_b = (_a = err === null || err === void 0 ? void 0 : err.response) === null || _a === void 0 ? void 0 : _a.data) === null || _b === void 0 ? void 0 : _b.message) !== null && _c !== void 0 ? _c : err === null || err === void 0 ? void 0 : err.message) !== null && _d !== void 0 ? _d : 'SwiftProof request failed';
+            const status = (_e = err === null || err === void 0 ? void 0 : err.response) === null || _e === void 0 ? void 0 : _e.status;
+            const error = new Error(`SwiftProof [${status}]: ${message}`);
+            return Promise.reject(error);
+        });
+    }
+}
+exports.SwiftProof = SwiftProof;
+// Default export
+exports.default = SwiftProof;

package/src/index.ts

@@ -0,0 +1,471 @@
+/**
+ * SwiftProof JavaScript/TypeScript SDK
+ *
+ * Proof-of-work infrastructure for any industry where
+ * something needs to be verified.
+ *
+ * npm install swiftproof
+ */
+
+// ─────────────────────────────────────────────────────────────────────────────
+// PROOF EVENT — the core object every chain produces
+// Every confirmation in every industry maps to this same shape
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * A single verified proof event — one step in a chain of custody.
+ *
+ * Every proof event answers five universal questions:
+ *   → who did it       = actor
+ *   → what happened    = event
+ *   → when it happened = confirmed_at
+ *   → where it happened = location + lat + lng
+ *   → evidence          = photo_url
+ *
+ * The hash field makes it tamper-proof:
+ * each hash includes the previous one, so altering any
+ * record breaks the entire chain and is caught by verify().
+ */
+export interface ProofEvent {
+  /** What happened — e.g. "delivered", "inspected", "dispensed", "signed" */
+  event: string;
+
+  /** Who did it — e.g. "Rider — Emeka", "Pharmacist", "Inspector" */
+  actor: string;
+
+  /** Whether this step has been confirmed yet */
+  confirmed: boolean;
+
+  /** Exact ISO timestamp of when the actor tapped confirm — null if not yet confirmed */
+  confirmed_at: string | null;
+
+  /** Human-readable location name (reverse geocoded) — e.g. "Allen Avenue, Ikeja" */
+  location: string | null;
+
+  /** GPS latitude at moment of confirmation */
+  lat: number | null;
+
+  /** GPS longitude at moment of confirmation */
+  lng: number | null;
+
+  /** Photo evidence URL (Cloudinary) — attached by actor at confirmation */
+  photo_url: string | null;
+
+  /**
+   * SHA-256 hash of this event chained to the previous one.
+   * If this hash doesn't match when verify() recomputes it,
+   * the chain is flagged as tampered.
+   */
+  hash: string | null;
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// HANDOFF — a pending proof event (before confirmation)
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * A pending step in a chain — waiting for the actor to confirm.
+ * Returned when you create a chain, before any confirmation happens.
+ */
+export interface PendingHandoff {
+  /** Unique handoff ID */
+  id: string;
+
+  /** What this step is — e.g. "pickup", "delivered" */
+  event: string;
+
+  /** Who needs to confirm this step */
+  actor: string;
+
+  /**
+   * The URL to send to the actor.
+   * When they open this link on any phone browser and tap confirm,
+   * their GPS is captured automatically and the proof event is recorded.
+   * No app download. No account. Just tap.
+   */
+  confirmation_url: string;
+
+  /** Raw token embedded in confirmation_url — for reference only */
+  confirmation_token: string;
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// CHAIN — a complete chain of custody
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * A chain of custody — ties multiple proof events together
+ * under one verifiable record.
+ *
+ * One chain per real-world event:
+ *   - one food delivery
+ *   - one pharmaceutical dispensing
+ *   - one field agent visit
+ *   - one court document service
+ *   - one construction milestone
+ */
+export interface Chain {
+  /** Unique chain ID — reference this when calling getChain() or verify() */
+  chain_id: string;
+
+  /** Human-readable title — e.g. "Order #1234 — Amaka Johnson" */
+  title: string;
+
+  /**
+   * Current status of the chain:
+   * - "open"      → some steps still pending confirmation
+   * - "completed" → all steps confirmed, chain is sealed
+   */
+  status: 'open' | 'completed';
+
+  /**
+   * Public tracking URL — send this to whoever is waiting on the delivery.
+   * They open it in any browser. No account needed.
+   * Updates automatically every 15 seconds as steps are confirmed.
+   */
+  tracking_url: string;
+
+  /** Raw tracking token embedded in tracking_url */
+  tracking_token: string;
+
+  /**
+   * One per actor you defined when creating the chain.
+   * Send each confirmation_url to the relevant party:
+   *   chain.handoffs[0].confirmation_url → Kitchen
+   *   chain.handoffs[1].confirmation_url → Rider (pickup)
+   *   chain.handoffs[2].confirmation_url → Rider (delivery)
+   */
+  handoffs: PendingHandoff[];
+
+  /** ISO timestamp of when this chain was created */
+  created_at: string;
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// CHAIN DETAIL — full audit trail (from getChain())
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Full chain detail including the complete audit trail.
+ * Returned by getChain() — use this to see the current state
+ * of every step and all captured evidence.
+ */
+export interface ChainDetail {
+  chain_id: string;
+  title: string;
+  status: 'open' | 'completed';
+  metadata: Record<string, any>;
+  tracking_url: string;
+
+  /** SHA-256 hash of the entire completed chain — null until all steps confirmed */
+  integrity_hash: string | null;
+
+  /** Whether the chain has been tampered with */
+  tampered: boolean;
+
+  /**
+   * True only when:
+   *   - status === "completed" (all steps confirmed)
+   *   - tampered === false (no records altered)
+   */
+  verified: boolean;
+
+  created_at: string;
+
+  /**
+   * The complete audit trail — one ProofEvent per actor.
+   * Each event answers: who, what, when, where, evidence.
+   */
+  trail: (ProofEvent & {
+    id: string;
+    note: string | null;
+    /** confirmation_url is null once the step has been confirmed (link is spent) */
+    confirmation_url: string | null;
+  })[];
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// VERIFICATION RESULT — from verify()
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Result of calling verify() on a completed chain.
+ *
+ * Use this when:
+ *   - A customer disputes a delivery
+ *   - A regulator asks for proof of an event
+ *   - An auditor needs to confirm a record wasn't altered
+ *   - Anyone needs to know: did this actually happen?
+ *
+ * verified: true  → every step happened as recorded, nothing was altered
+ * verified: false → chain is incomplete or tampered
+ */
+export interface VerificationResult {
+  chain_id: string;
+  title: string;
+  status: 'open' | 'completed';
+
+  /**
+   * The single most important field.
+   * true  = this chain is real, complete, and untampered
+   * false = incomplete or evidence of tampering
+   */
+  verified: boolean;
+
+  /** true if any record in the chain was altered after the fact */
+  tampered: boolean;
+
+  /** SHA-256 hash of the entire chain — for external audit records */
+  integrity_hash: string | null;
+
+  /** ISO timestamp of when the final step was confirmed */
+  completed_at: string | null;
+
+  /** Number of steps confirmed in this chain */
+  handoff_count: number;
+
+  /**
+   * The verified audit trail.
+   * Each entry is a cryptographically verified ProofEvent.
+   */
+  trail: (Pick<
+    ProofEvent,
+    'event' | 'actor' | 'confirmed_at' | 'location' | 'hash'
+  > & {
+    /** true if this specific step's hash verified correctly */
+    valid: boolean;
+  })[];
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// INPUT TYPES — what you pass in
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * One actor in a chain — defines a step that needs to be confirmed.
+ *
+ * Use plain language that makes sense for your industry:
+ *   Food:         { event: "packed",    actor: "Kitchen" }
+ *   Pharmacy:     { event: "dispensed", actor: "Pharmacist" }
+ *   Banking:      { event: "dispatched",actor: "Branch Officer" }
+ *   Construction: { event: "milestone_complete", actor: "Contractor" }
+ *   Legal:        { event: "served",    actor: "Process Server" }
+ *   Insurance:    { event: "assessed",  actor: "Claims Assessor" }
+ */
+export interface ProofActor {
+  /** What happens at this step — use plain language from your domain */
+  event: string;
+
+  /** Who is responsible for confirming this step */
+  actor: string;
+
+  /** Optional internal note about this step */
+  note?: string;
+}
+
+/** Input for creating a new chain of custody */
+export interface CreateChainInput {
+  /**
+   * Human-readable title for this chain.
+   * Include enough context to identify it later:
+   *   "Order #1234 — Amaka Johnson"
+   *   "Prescription #5567 — Mrs Obi"
+   *   "Site inspection — Plot 14, Lekki"
+   */
+  title: string;
+
+  /**
+   * Any extra data you want to store with this chain.
+   * Does not affect the proof logic — purely for your reference.
+   */
+  metadata?: Record<string, any>;
+
+  /**
+   * The steps that need to be confirmed, in order.
+   * Each one gets its own confirmation_url.
+   * Steps are confirmed independently — order is tracked by timestamp.
+   */
+  actors: ProofActor[];
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// SDK CLIENT
+// ─────────────────────────────────────────────────────────────────────────────
+
+export interface SwiftProofConfig {
+  /** Your API key — starts with sp_live_ or sp_test_ */
+  apiKey: string;
+
+  /**
+   * API base URL.
+   * Defaults to https://swiftproof-infra.onrender.com
+   * Override for local development: http://localhost:4000
+   */
+  baseUrl?: string;
+}
+
+/**
+ * SwiftProof SDK
+ *
+ * Proof-of-work infrastructure. One API call captures tamper-proof
+ * evidence of any event in any industry.
+ *
+ * @example
+ * ```typescript
+ * const sp = new SwiftProof({ apiKey: 'sp_live_xxx' });
+ *
+ * const chain = await sp.chains.create({
+ *   title: 'Order #1234 — Amaka Johnson',
+ *   actors: [
+ *     { event: 'packed',    actor: 'Kitchen' },
+ *     { event: 'pickup',    actor: 'Rider — Emeka' },
+ *     { event: 'delivered', actor: 'Rider — Emeka' },
+ *   ],
+ * });
+ *
+ * // Send these to the relevant parties
+ * chain.handoffs[0].confirmation_url  // → Kitchen
+ * chain.handoffs[1].confirmation_url  // → Rider (pickup)
+ * chain.handoffs[2].confirmation_url  // → Rider (delivery)
+ *
+ * // Send this to the customer
+ * chain.tracking_url
+ *
+ * // Later — verify everything happened
+ * const proof = await sp.chains.verify(chain.chain_id);
+ * proof.verified  // true = happened, untampered
+ * proof.tampered  // false = nothing altered
+ * ```
+ */
+export class SwiftProof {
+  private readonly baseUrl: string;
+  private readonly headers: Record<string, string>;
+
+  constructor(config: SwiftProofConfig) {
+    if (!config.apiKey) throw new Error('SwiftProof: apiKey is required');
+    if (!config.apiKey.startsWith('sp_')) {
+      throw new Error(
+        'SwiftProof: apiKey must start with sp_live_ or sp_test_',
+      );
+    }
+    this.baseUrl = (
+      config.baseUrl ?? 'https://swiftproof-infra.onrender.com'
+    ).replace(/\/$/, '');
+    this.headers = {
+      'Content-Type': 'application/json',
+      Authorization: `Bearer ${config.apiKey}`,
+    };
+  }
+
+  private async request<T>(
+    method: string,
+    path: string,
+    body?: unknown,
+  ): Promise<T> {
+    const res = await fetch(`${this.baseUrl}${path}`, {
+      method,
+      headers: this.headers,
+      body: body !== undefined ? JSON.stringify(body) : undefined,
+    });
+
+    const data = await res.json().catch(() => ({}));
+
+    if (!res.ok) {
+      const message =
+        (data as any)?.message ?? `Request failed with status ${res.status}`;
+      const err = new Error(`SwiftProof API error: ${message}`) as any;
+      err.status = res.status;
+      err.response = data;
+      throw err;
+    }
+
+    return data as T;
+  }
+
+  /** All chain of custody operations */
+  readonly chains = {
+    /**
+     * Create a new chain of custody.
+     *
+     * Call this when a real-world handoff event begins:
+     * an order is placed, a delivery is dispatched,
+     * an inspection is scheduled, a document is to be served.
+     *
+     * Returns confirmation URLs for each actor and a
+     * tracking URL for the end recipient.
+     *
+     * @example
+     * ```typescript
+     * const chain = await sp.chains.create({
+     *   title: 'Order #1234',
+     *   actors: [
+     *     { event: 'packed',    actor: 'Kitchen' },
+     *     { event: 'delivered', actor: 'Rider' },
+     *   ],
+     * });
+     *
+     * // Kitchen taps this link → GPS captured → "packed" confirmed
+     * chain.handoffs[0].confirmation_url
+     *
+     * // Customer opens this → sees live status timeline
+     * chain.tracking_url
+     * ```
+     */
+    create: (input: CreateChainInput): Promise<Chain> =>
+      this.request<Chain>('POST', '/v1/chains', input),
+
+    /**
+     * Get the full audit trail for a chain.
+     *
+     * Shows every step — confirmed or pending —
+     * with all captured evidence: GPS, timestamp, photo, hash.
+     *
+     * @example
+     * ```typescript
+     * const detail = await sp.chains.get('sp_ch_abc123');
+     * detail.trail.forEach(step => {
+     *   console.log(step.event, step.confirmed_at, step.location);
+     * });
+     * ```
+     */
+    get: (chainId: string): Promise<ChainDetail> =>
+      this.request<ChainDetail>('GET', `/v1/chains/${chainId}`),
+
+    /**
+     * Verify a completed chain of custody.
+     *
+     * Recomputes every hash in the chain and confirms nothing
+     * was altered after the fact.
+     *
+     * Use this when:
+     * - A customer disputes a delivery
+     * - A regulator asks for proof
+     * - An auditor needs to confirm records are untampered
+     *
+     * @returns VerificationResult with verified: true if chain is
+     * complete and cryptographically intact
+     *
+     * @example
+     * ```typescript
+     * const proof = await sp.chains.verify('sp_ch_abc123');
+     *
+     * if (proof.verified) {
+     *   // Chain is complete and untampered
+     *   // Show proof.trail as evidence
+     * } else if (proof.tampered) {
+     *   // Records were altered — do not use as evidence
+     * } else {
+     *   // Chain not yet complete — some steps pending
+     * }
+     * ```
+     */
+    verify: (chainId: string): Promise<VerificationResult> =>
+      this.request<VerificationResult>('GET', `/v1/chains/${chainId}/verify`),
+  };
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// DEFAULT EXPORT
+// ─────────────────────────────────────────────────────────────────────────────
+
+export default SwiftProof;

package/src/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/src/types.ts

@@ -0,0 +1,101 @@
+export interface SwiftProofConfig {
+  apiKey: string;
+  baseUrl?: string;
+}
+
+export interface Actor {
+  event: string;
+  actor: string;
+  note?: string;
+}
+
+export interface CreateChainParams {
+  title: string;
+  metadata?: Record<string, any>;
+  actors: Actor[];
+}
+
+export interface ConfirmHandoffParams {
+  lat?: number;
+  lng?: number;
+  note?: string;
+  metadata?: Record<string, any>;
+}
+
+export interface Handoff {
+  id: string;
+  event: string;
+  actor: string;
+  confirmed: boolean;
+  confirmed_at: string | null;
+  location: string | null;
+  lat: number | null;
+  lng: number | null;
+  note: string | null;
+  hash: string | null;
+  confirmation_url: string | null;
+  confirmation_token?: string;
+}
+
+export interface Chain {
+  chain_id: string;
+  title: string;
+  status: 'open' | 'completed' | 'cancelled';
+  tracking_url: string;
+  tracking_token: string;
+  metadata?: Record<string, any>;
+  integrity_hash: string | null;
+  tampered: boolean;
+  verified: boolean;
+  created_at: string;
+  trail?: Handoff[];
+  handoffs?: Handoff[];
+}
+
+export interface VerifyResult {
+  chain_id: string;
+  title: string;
+  status: string;
+  verified: boolean;
+  tampered: boolean;
+  integrity_hash: string | null;
+  completed_at: string | null;
+  handoff_count: number;
+  trail: Array<{
+    event: string;
+    actor: string;
+    confirmed_at: string;
+    location: string | null;
+    hash: string;
+    valid: boolean;
+  }>;
+}
+
+export interface ConfirmResult {
+  success: boolean;
+  handoff_id: string;
+  event: string;
+  actor: string;
+  confirmed_at: string;
+  location: string | null;
+  chain_status: string;
+  message: string;
+}
+
+export interface TrackingResult {
+  title: string;
+  status: string;
+  current_location: string | null;
+  current_lat: number | null;
+  current_lng: number | null;
+  last_update: string | null;
+  trail: Array<{
+    event: string;
+    actor: string;
+    confirmed: boolean;
+    confirmed_at: string | null;
+    location: string | null;
+    lat: number | null;
+    lng: number | null;
+  }>;
+}

package/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2018",
+    "module": "commonjs",
+
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "lib": ["ES2020", "DOM"],
+    "outDir": "./dist",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "ignoreDeprecations": "5.0"
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/tsup.config.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tsup_1 = require("tsup");
+exports.default = (0, tsup_1.defineConfig)({
+    entry: ['src/index.ts'],
+    format: ['cjs', 'esm'],
+    dts: false,
+    clean: true,
+    sourcemap: true,
+    treeshake: true,
+    tsconfig: './tsconfig.json',
+});

package/tsup.config.ts

@@ -0,0 +1,11 @@
+import { defineConfig } from 'tsup';
+
+export default defineConfig({
+  entry: ['src/index.ts'],
+  format: ['cjs', 'esm'],
+  dts: false,
+  clean: true,
+  sourcemap: true,
+  treeshake: true,
+  tsconfig: './tsconfig.json',
+});