@versedbcom/sdk 0.1.1

package/esm/types/smart-union.js

@@ -0,0 +1,117 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+// Not needed if lax mode
+import * as z from "zod/v4-mini";
+import { startCountingDefaultToZeroValue } from "./default-to-zero-value.js";
+import { RFCDate } from "./rfcdate.js";
+import { startCountingUnrecognized } from "./unrecognized.js";
+/**
+ * Smart union parser that tries all schemas and returns the best match
+ * based on the number of populated fields.
+ */
+export function smartUnion(options) {
+    return z.pipe(z.unknown(), z.transform((input, ctx) => {
+        const candidates = [];
+        const errors = options.map(() => []);
+        const parentUnrecognizedCtr = startCountingUnrecognized();
+        const parentZeroDefaultCtr = startCountingDefaultToZeroValue();
+        // Filter out invalid options
+        for (const [i, option] of options.entries()) {
+            const unrecognizedCtr = startCountingUnrecognized();
+            const zeroDefaultCtr = startCountingDefaultToZeroValue();
+            const result = option.safeParse(input);
+            const inexactCount = unrecognizedCtr.end();
+            const zeroDefaultCount = zeroDefaultCtr.end();
+            if (result.success) {
+                candidates.push({
+                    data: result.data,
+                    inexactCount,
+                    zeroDefaultCount,
+                    fieldCount: -1, // We'll count this later if needed
+                });
+                continue;
+            }
+            errors[i].push(...result.error.issues);
+        }
+        // No valid options
+        if (candidates.length === 0) {
+            parentUnrecognizedCtr.end(0);
+            parentZeroDefaultCtr.end(0);
+            ctx.issues.push({
+                input: input,
+                code: "invalid_union",
+                errors: errors,
+            });
+            return z.NEVER;
+        }
+        let best = candidates[0];
+        // Find the best option
+        for (const candidate of candidates) {
+            // Minor optimization to avoid counting fields if there's only one candidate
+            if (candidates.length > 1) {
+                candidate.fieldCount = countFieldsRecursive(candidate.data);
+            }
+            best = better(candidate, best);
+        }
+        // The cost of this union should be the cost of the best candidate not all the candidates
+        parentUnrecognizedCtr.end(best.inexactCount);
+        parentZeroDefaultCtr.end(best.zeroDefaultCount);
+        return best.data;
+    }));
+}
+function better(a, b) {
+    // First prefer exact matches over inexact ones
+    const aIsExact = a.inexactCount === 0;
+    const bIsExact = b.inexactCount === 0;
+    if (aIsExact !== bIsExact) {
+        return aIsExact ? a : b;
+    }
+    // Then compare field counts
+    const actualFieldCountA = a.fieldCount - a.zeroDefaultCount;
+    const actualFieldCountB = b.fieldCount - b.zeroDefaultCount;
+    if (actualFieldCountA !== actualFieldCountB) {
+        return actualFieldCountA > actualFieldCountB ? a : b;
+    }
+    return a.inexactCount < b.inexactCount ? a : b;
+}
+/**
+ * Counts the number of fields in a parsed value recursively.
+ * @param `parsed` assumed to *not* contain cycles
+ * fieldCount: total number of fields found
+ * inexactCount: number of primitive values that are not unrecognized enum values
+ */
+function countFieldsRecursive(parsed) {
+    let fieldCount = 0;
+    const queue = [parsed];
+    let index = 0;
+    while (index < queue.length) {
+        const value = queue[index++];
+        if (value === undefined) {
+            continue;
+        }
+        // Check if it's a primitive value
+        const type = typeof value;
+        if (value === null
+            || type === "number"
+            || type === "string"
+            || type === "boolean"
+            || type === "bigint"
+            || value instanceof Date
+            || value instanceof RFCDate) {
+            fieldCount++;
+            continue;
+        }
+        // Handle arrays
+        if (Array.isArray(value)) {
+            queue.push(...value);
+            continue;
+        }
+        // Handle objects
+        if (type === "object") {
+            queue.push(...Object.values(value));
+        }
+    }
+    return fieldCount;
+}
+//# sourceMappingURL=smart-union.js.map

package/esm/types/smart-union.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-union.js","sourceRoot":"","sources":["../../src/types/smart-union.ts"],"names":[],"mappings":"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"}

package/esm/types/streams.d.ts

@@ -0,0 +1,2 @@
+export declare function isReadableStream<T = Uint8Array>(val: unknown): val is ReadableStream<T>;
+//# sourceMappingURL=streams.d.ts.map

package/esm/types/streams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streams.d.ts","sourceRoot":"","sources":["../../src/types/streams.ts"],"names":[],"mappings":"AAIA,wBAAgB,gBAAgB,CAAC,CAAC,GAAG,UAAU,EAC7C,GAAG,EAAE,OAAO,GACX,GAAG,IAAI,cAAc,CAAC,CAAC,CAAC,CAc1B"}

package/esm/types/streams.js

@@ -0,0 +1,15 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+export function isReadableStream(val) {
+    if (typeof val !== "object" || val === null) {
+        return false;
+    }
+    // Check for the presence of methods specific to ReadableStream
+    const stream = val;
+    // ReadableStream has methods like getReader, cancel, and tee
+    return (typeof stream.getReader === "function" &&
+        typeof stream.cancel === "function" &&
+        typeof stream.tee === "function");
+}
+//# sourceMappingURL=streams.js.map

package/esm/types/streams.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streams.js","sourceRoot":"","sources":["../../src/types/streams.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,UAAU,gBAAgB,CAC9B,GAAY,EACc;IAC1B,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAC5C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,+DAA+D;IAC/D,MAAM,MAAM,GAAG,GAAiC,CAAC;IAEjD,6DAA6D;IAC7D,OAAO,CACL,OAAO,MAAM,CAAC,SAAS,KAAK,UAAU;QACtC,OAAO,MAAM,CAAC,MAAM,KAAK,UAAU;QACnC,OAAO,MAAM,CAAC,GAAG,KAAK,UAAU,CACjC,CAAC;AAAA,CACH"}

package/esm/types/unrecognized.d.ts

@@ -0,0 +1,16 @@
+declare const __brand: unique symbol;
+export type Unrecognized<T> = T & {
+    [__brand]: "unrecognized";
+};
+declare function unrecognized<T>(value: T): Unrecognized<T>;
+export declare function startCountingUnrecognized(): {
+    /**
+     * Ends counting and returns the delta.
+     * @param delta - If provided, only this amount is added to the parent counter
+     *   (used for nested unions where we only want to record the winning option's count).
+     *   If not provided, records all counts since start().
+     */
+    end: (delta?: number | undefined) => number;
+};
+export { unrecognized };
+//# sourceMappingURL=unrecognized.d.ts.map

package/esm/types/unrecognized.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unrecognized.d.ts","sourceRoot":"","sources":["../../src/types/unrecognized.ts"],"names":[],"mappings":"AAIA,OAAO,CAAC,MAAM,OAAO,EAAE,OAAO,MAAM,CAAC;AACrC,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG;IAAE,CAAC,OAAO,CAAC,EAAE,cAAc,CAAA;CAAE,CAAC;AAEhE,iBAAS,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAGlD;AAID,wBAAgB,yBAAyB;IAIrC;;;;;OAKG;;EASN;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/esm/types/unrecognized.js

@@ -0,0 +1,31 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+function unrecognized(value) {
+    globalCount++;
+    return value;
+}
+let globalCount = 0;
+let refCount = 0;
+export function startCountingUnrecognized() {
+    refCount++;
+    const start = globalCount;
+    return {
+        /**
+         * Ends counting and returns the delta.
+         * @param delta - If provided, only this amount is added to the parent counter
+         *   (used for nested unions where we only want to record the winning option's count).
+         *   If not provided, records all counts since start().
+         */
+        end: (delta) => {
+            const count = globalCount - start;
+            // Reset globalCount back to start, then add only the specified delta
+            globalCount = start + (delta ?? count);
+            if (--refCount === 0)
+                globalCount = 0;
+            return count;
+        },
+    };
+}
+export { unrecognized };
+//# sourceMappingURL=unrecognized.js.map

package/esm/types/unrecognized.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unrecognized.js","sourceRoot":"","sources":["../../src/types/unrecognized.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,SAAS,YAAY,CAAI,KAAQ,EAAmB;IAClD,WAAW,EAAE,CAAC;IACd,OAAO,KAAwB,CAAC;AAAA,CACjC;AAED,IAAI,WAAW,GAAG,CAAC,CAAC;AACpB,IAAI,QAAQ,GAAG,CAAC,CAAC;AACjB,MAAM,UAAU,yBAAyB,GAAG;IAC1C,QAAQ,EAAE,CAAC;IACX,MAAM,KAAK,GAAG,WAAW,CAAC;IAC1B,OAAO;QACL;;;;;WAKG;QACH,GAAG,EAAE,CAAC,KAAc,EAAE,EAAE,CAAC;YACvB,MAAM,KAAK,GAAG,WAAW,GAAG,KAAK,CAAC;YAClC,qEAAqE;YACrE,WAAW,GAAG,KAAK,GAAG,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC;YACvC,IAAI,EAAE,QAAQ,KAAK,CAAC;gBAAE,WAAW,GAAG,CAAC,CAAC;YACtC,OAAO,KAAK,CAAC;QAAA,CACd;KACF,CAAC;AAAA,CACH;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/examples/activityGetActivityFeed.example.ts

@@ -0,0 +1,28 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import dotenv from "dotenv";
+dotenv.config();
+/**
+ * Example usage of the @versedbcom/sdk SDK
+ *
+ * To run this example from the examples directory:
+ * npm run build && npx tsx activityGetActivityFeed.example.ts
+ */
+
+import { VerseDB } from "@versedbcom/sdk";
+
+const verseDB = new VerseDB({
+  default: "<YOUR_BEARER_TOKEN_HERE>",
+});
+
+async function main() {
+  const result = await verseDB.activity.getActivityFeed({
+    perPage: 20,
+  });
+
+  console.log(result);
+}
+
+main().catch(console.error);

package/examples/barcode-sync.ts

@@ -0,0 +1,49 @@
+import dotenv from "dotenv";
+dotenv.config();
+/**
+ * The ComicTagger-style flow: scan a barcode, resolve the issue, record the copy.
+ * Requires the `lookup:barcode` and `write:collection` token abilities.
+ *
+ * To run from the examples directory:
+ * npm run build && VERSEDB_TOKEN=... npx tsx barcode-sync.ts
+ */
+
+import { VerseDB } from "@versedbcom/sdk";
+import * as errors from "@versedbcom/sdk/models/errors";
+
+const verseDB = new VerseDB({
+  default: process.env.VERSEDB_TOKEN!,
+});
+
+async function main() {
+  try {
+    const lookup = await verseDB.barcodeLookup.lookupByUPC({
+      upc: "75960608936700111",
+    });
+
+    const issue = lookup.result?.data;
+    if (!issue?.id) return;
+
+    await verseDB.userCollections.addIssueToCollection({
+      issueId: issue.id,
+      body: {
+        condition: "NM",
+        pricePaid: 4.99,
+      },
+    });
+    console.log(`Added ${issue.name} to collection`);
+  } catch (err) {
+    // Pre-1995 barcodes are not unique — a 409 carries candidate matches to pick from.
+    if (err instanceof errors.LookupByUPCConflictError) {
+      for (const match of err.matches ?? []) {
+        console.log(
+          `${match.seriesName} #${match.issueNumber} (${match.releaseDate}) — issue id ${match.issueId}`,
+        );
+      }
+      return;
+    }
+    throw err;
+  }
+}
+
+main().catch(console.error);

package/examples/lists.ts

@@ -0,0 +1,48 @@
+import dotenv from "dotenv";
+dotenv.config();
+/**
+ * Create a list, add items, reorder, browse popular lists.
+ * Requires the `write:list` token ability.
+ *
+ * To run from the examples directory:
+ * npm run build && VERSEDB_TOKEN=... npx tsx lists.ts
+ */
+
+import { VerseDB } from "@versedbcom/sdk";
+
+const verseDB = new VerseDB({
+  default: process.env.VERSEDB_TOKEN!,
+});
+
+async function main() {
+  const list = await verseDB.lists.createList({
+    title: "Essential X-Men",
+    entityType: "issues",
+  });
+
+  const listId = list.result?.data?.id;
+  if (!listId) return;
+
+  const first = await verseDB.lists.addItemToList({
+    listId,
+    body: { entityId: 5432 },
+  });
+  const second = await verseDB.lists.addItemToList({
+    listId,
+    body: { entityId: 5433 },
+  });
+
+  const firstId = first.result?.data?.id;
+  const secondId = second.result?.data?.id;
+  if (firstId && secondId) {
+    await verseDB.lists.reorderItems({
+      listId,
+      body: { itemIds: [secondId, firstId] },
+    });
+  }
+
+  const popular = await verseDB.lists.browseLists({ sort: "popular" });
+  console.log(popular.result?.data?.map((l) => l.title));
+}
+
+main().catch(console.error);

package/examples/node_modules/@types/node/assert/strict.d.ts

@@ -0,0 +1,8 @@
+declare module "assert/strict" {
+    import { strict } from "node:assert";
+    export = strict;
+}
+declare module "node:assert/strict" {
+    import { strict } from "node:assert";
+    export = strict;
+}