@superwall/core 0.2.0 → 0.2.1

package/dist/errors.d.ts

@@ -0,0 +1,49 @@
+export type SuperwallErrorCode = "NETWORK" | "AUTH" | "NOT_FOUND" | "TIMEOUT" | "DECODING";
+export declare class SuperwallError extends Error {
+    readonly name: string;
+    readonly code: SuperwallErrorCode;
+    constructor(message: string, code: SuperwallErrorCode);
+}
+export declare class SuperwallNetworkError extends SuperwallError {
+    readonly name = "SuperwallNetworkError";
+    readonly status?: number;
+    readonly url?: string;
+    readonly cause?: unknown;
+    constructor(message: string, opts?: {
+        status?: number;
+        url?: string;
+        cause?: unknown;
+    });
+}
+export declare class SuperwallAuthError extends SuperwallError {
+    readonly name = "SuperwallAuthError";
+    readonly url?: string;
+    constructor(message: string, opts?: {
+        url?: string;
+    });
+}
+export declare class SuperwallNotFoundError extends SuperwallError {
+    readonly name = "SuperwallNotFoundError";
+    readonly url?: string;
+    constructor(message: string, opts?: {
+        url?: string;
+    });
+}
+export declare class SuperwallTimeoutError extends SuperwallError {
+    readonly name = "SuperwallTimeoutError";
+    readonly url?: string;
+    readonly timeoutMs?: number;
+    constructor(message: string, opts?: {
+        url?: string;
+        timeoutMs?: number;
+    });
+}
+export declare class SuperwallDecodingError extends SuperwallError {
+    readonly name = "SuperwallDecodingError";
+    readonly url?: string;
+    readonly cause?: unknown;
+    constructor(message: string, opts?: {
+        url?: string;
+        cause?: unknown;
+    });
+}

package/dist/errors.js

@@ -0,0 +1,69 @@
+// Plain error classes shared between browser and server SDKs. The browser
+// SDK has additional Effect-flavored variants in its own `internal/errors.ts`
+// — those translate to these classes at the runtime boundary. Server SDK
+// uses these directly.
+export class SuperwallError extends Error {
+    name = "SuperwallError";
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+    }
+}
+export class SuperwallNetworkError extends SuperwallError {
+    name = "SuperwallNetworkError";
+    status;
+    url;
+    cause;
+    constructor(message, opts = {}) {
+        super(message, "NETWORK");
+        if (opts.status !== undefined)
+            this.status = opts.status;
+        if (opts.url !== undefined)
+            this.url = opts.url;
+        if (opts.cause !== undefined)
+            this.cause = opts.cause;
+    }
+}
+export class SuperwallAuthError extends SuperwallError {
+    name = "SuperwallAuthError";
+    url;
+    constructor(message, opts = {}) {
+        super(message, "AUTH");
+        if (opts.url !== undefined)
+            this.url = opts.url;
+    }
+}
+export class SuperwallNotFoundError extends SuperwallError {
+    name = "SuperwallNotFoundError";
+    url;
+    constructor(message, opts = {}) {
+        super(message, "NOT_FOUND");
+        if (opts.url !== undefined)
+            this.url = opts.url;
+    }
+}
+export class SuperwallTimeoutError extends SuperwallError {
+    name = "SuperwallTimeoutError";
+    url;
+    timeoutMs;
+    constructor(message, opts = {}) {
+        super(message, "TIMEOUT");
+        if (opts.url !== undefined)
+            this.url = opts.url;
+        if (opts.timeoutMs !== undefined)
+            this.timeoutMs = opts.timeoutMs;
+    }
+}
+export class SuperwallDecodingError extends SuperwallError {
+    name = "SuperwallDecodingError";
+    url;
+    cause;
+    constructor(message, opts = {}) {
+        super(message, "DECODING");
+        if (opts.url !== undefined)
+            this.url = opts.url;
+        if (opts.cause !== undefined)
+            this.cause = opts.cause;
+    }
+}

package/dist/hosts.d.ts

@@ -0,0 +1,3 @@
+import type { EnvironmentHosts, NetworkEnvironment } from "./types.js";
+export declare const resolveHosts: (env: NetworkEnvironment) => EnvironmentHosts;
+export declare const isSandbox: (env: NetworkEnvironment) => boolean;

package/dist/hosts.js

@@ -0,0 +1,33 @@
+const RELEASE_HOSTS = {
+    base: "api.superwall.me",
+    collector: "collector.superwall.com",
+    enrichment: "enrichment-api.superwall.com",
+    subscriptions: "subscriptions-api.superwall.com",
+};
+const RC_HOSTS = {
+    base: "api.superwallcanary.com",
+    collector: "collector.superwallcanary.com",
+    enrichment: "enrichment-api.superwall.dev",
+    subscriptions: "subscriptions-api.superwall.dev",
+};
+const DEV_HOSTS = {
+    base: "api.superwall.dev",
+    collector: "collector.superwall.com",
+    enrichment: "enrichment-api.superwall.dev",
+    subscriptions: "subscriptions-api.superwall.dev",
+};
+export const resolveHosts = (env) => {
+    if (typeof env === "string") {
+        switch (env) {
+            case "release":
+                return RELEASE_HOSTS;
+            case "releaseCandidate":
+                return RC_HOSTS;
+            case "developer":
+                return DEV_HOSTS;
+        }
+    }
+    return env.custom;
+};
+// Custom environments are typically internal proxies → assume production.
+export const isSandbox = (env) => typeof env === "string" ? env !== "release" : false;

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./types.js";
+export * from "./hosts.js";
+export * from "./wire.js";
+export * from "./errors.js";

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from "./types.js";
+export * from "./hosts.js";
+export * from "./wire.js";
+export * from "./errors.js";

package/dist/types.d.ts

@@ -0,0 +1,69 @@
+export type JsonValue = string | number | boolean | null | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export type SubscriptionStatus = {
+    status: "UNKNOWN";
+} | {
+    status: "INACTIVE";
+} | {
+    status: "ACTIVE";
+    entitlements: Entitlement[];
+};
+export type ProductStore = "appStore" | "stripe" | "paddle" | "playStore" | "superwall" | "other";
+export type LatestSubscriptionState = "inGracePeriod" | "subscribed" | "expired" | "inBillingRetryPeriod" | "revoked";
+export type LatestSubscriptionOfferType = "trial" | "code" | "promotional" | "winback";
+export interface Entitlement {
+    id: string;
+    type: "SERVICE_LEVEL";
+    isActive: boolean;
+    productIds: string[];
+    latestProductId?: string;
+    store?: ProductStore;
+    startsAt?: number;
+    renewedAt?: number;
+    expiresAt?: number;
+    isLifetime?: boolean;
+    willRenew?: boolean;
+    state?: LatestSubscriptionState;
+    offerType?: LatestSubscriptionOfferType;
+}
+export interface Entitlements {
+    active: Entitlement[];
+    inactive: Entitlement[];
+    all: Entitlement[];
+}
+export type PaywallPresentationStyle = {
+    type: "MODAL";
+} | {
+    type: "FULLSCREEN";
+} | {
+    type: "NO_ANIMATION";
+} | {
+    type: "PUSH";
+} | {
+    type: "DRAWER";
+    height: number;
+    cornerRadius: number;
+} | {
+    type: "POPUP";
+    height: number;
+    width: number;
+    cornerRadius: number;
+} | {
+    type: "NONE";
+};
+export interface CustomEnvironmentHosts {
+    base: string;
+    collector: string;
+    enrichment: string;
+    subscriptions: string;
+}
+export type NetworkEnvironment = "release" | "releaseCandidate" | "developer" | {
+    custom: CustomEnvironmentHosts;
+};
+export interface EnvironmentHosts {
+    readonly base: string;
+    readonly collector: string;
+    readonly enrichment: string;
+    readonly subscriptions: string;
+}

package/dist/types.js

@@ -0,0 +1,4 @@
+// Cross-SDK domain types. Anything shared between @superwall/paywalls-js
+// (browser) and @superwall/server lives here. Browser-only and server-only
+// types stay in their respective packages.
+export {};

package/dist/wire.d.ts

@@ -0,0 +1,26 @@
+import type { Entitlements } from "./types.js";
+export interface WebEntitlementsResponse {
+    readonly customerInfo?: {
+        entitlements?: ReadonlyArray<WireEntitlement>;
+    };
+    readonly entitlements?: ReadonlyArray<WireEntitlement>;
+    /** Short-lived (≈1h) Superwall-signed JWT asserting the active entitlements,
+     *  for offline server-side verification via `@superwall/verify`. Best-effort:
+     *  the backend omits it when signing is unavailable (e.g. no key configured
+     *  in that environment), so treat its absence gracefully. */
+    readonly entitlementsToken?: string;
+}
+export interface WireEntitlement {
+    /** BE wire shape uses `identifier`; older/other shapes use `id`. */
+    identifier?: string;
+    id?: string;
+    isActive?: boolean;
+    productIds?: string[];
+    type?: string;
+}
+/**
+ * Normalize a `WebEntitlementsResponse` into a domain `Entitlements`
+ * bucket. Prefers the `entitlements` top-level array if present, falls
+ * back to `customerInfo.entitlements`.
+ */
+export declare const parseEntitlements: (res: WebEntitlementsResponse) => Entitlements;

package/dist/wire.js

@@ -0,0 +1,28 @@
+const toDomain = (e) => ({
+    id: e.identifier ?? e.id ?? "",
+    type: "SERVICE_LEVEL",
+    isActive: e.isActive ?? false,
+    productIds: e.productIds ?? [],
+});
+/**
+ * Normalize a `WebEntitlementsResponse` into a domain `Entitlements`
+ * bucket. Prefers the `entitlements` top-level array if present, falls
+ * back to `customerInfo.entitlements`.
+ */
+export const parseEntitlements = (res) => {
+    // The BE sends `entitlements: []` (empty) at the top level and the real
+    // ones under `customerInfo.entitlements`. A plain `??` would pick the
+    // empty top-level array (it isn't nullish) and drop the real ones — so
+    // only fall back to the top level when customerInfo has nothing.
+    const wire = res.customerInfo?.entitlements && res.customerInfo.entitlements.length > 0
+        ? res.customerInfo.entitlements
+        : res.entitlements && res.entitlements.length > 0
+            ? res.entitlements
+            : (res.customerInfo?.entitlements ?? res.entitlements ?? []);
+    const all = wire.map(toDomain);
+    return {
+        active: all.filter((e) => e.isActive),
+        inactive: all.filter((e) => !e.isActive),
+        all,
+    };
+};

package/package.json

@@ -1,22 +1,31 @@
 {
   "name": "@superwall/core",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "type": "module",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
   },
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
   "exports": {
     ".": {
-      "types": "./src/index.ts",
-      "default": "./src/index.ts"
+      "@superwall/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
     }
   },
   "scripts": {
     "test": "bun test",
     "typecheck": "tsc --noEmit",
-    "build": "echo 'no-op for v0; consumers import .ts directly via Bun/Vite/Next ESM'",
-    "clean": "rm -rf node_modules .turbo *.tsbuildinfo"
+    "build": "bun run ../../scripts/build-package.ts",
+    "clean": "rm -rf dist node_modules .turbo *.tsbuildinfo"
   },
   "devDependencies": {
     "@types/bun": "latest",

package/.turbo/turbo-build.log

@@ -1,3 +0,0 @@
-
-$ echo 'no-op for v0; consumers import .ts directly via Bun/Vite/Next ESM'
-no-op for v0; consumers import .ts directly via Bun/Vite/Next ESM

package/.turbo/turbo-test.log

@@ -1,12 +0,0 @@
-$ bun test
-bun test v1.3.11 (af24e281)
-
-src/wire.test.ts:
-(pass) parseEntitlements reads the BE `identifier` field (not `id`) [0.40ms]
-(pass) parseEntitlements: isActive:false → inactive bucket, id still resolved [0.03ms]
-(pass) parseEntitlements: legacy `id` field still works [0.02ms]
-
- 3 pass
- 0 fail
- 7 expect() calls
-Ran 3 tests across 1 file. [14.00ms]

package/.turbo/turbo-typecheck.log

@@ -1 +0,0 @@
-$ tsc --noEmit

package/src/errors.ts

@@ -1,88 +0,0 @@
-// Plain error classes shared between browser and server SDKs. The browser
-// SDK has additional Effect-flavored variants in its own `internal/errors.ts`
-// — those translate to these classes at the runtime boundary. Server SDK
-// uses these directly.
-
-export type SuperwallErrorCode =
-  | "NETWORK"
-  | "AUTH"
-  | "NOT_FOUND"
-  | "TIMEOUT"
-  | "DECODING";
-
-export class SuperwallError extends Error {
-  override readonly name: string = "SuperwallError";
-  readonly code: SuperwallErrorCode;
-
-  constructor(message: string, code: SuperwallErrorCode) {
-    super(message);
-    this.code = code;
-  }
-}
-
-export class SuperwallNetworkError extends SuperwallError {
-  override readonly name = "SuperwallNetworkError";
-  readonly status?: number;
-  readonly url?: string;
-  override readonly cause?: unknown;
-
-  constructor(
-    message: string,
-    opts: { status?: number; url?: string; cause?: unknown } = {},
-  ) {
-    super(message, "NETWORK");
-    if (opts.status !== undefined) this.status = opts.status;
-    if (opts.url !== undefined) this.url = opts.url;
-    if (opts.cause !== undefined) this.cause = opts.cause;
-  }
-}
-
-export class SuperwallAuthError extends SuperwallError {
-  override readonly name = "SuperwallAuthError";
-  readonly url?: string;
-
-  constructor(message: string, opts: { url?: string } = {}) {
-    super(message, "AUTH");
-    if (opts.url !== undefined) this.url = opts.url;
-  }
-}
-
-export class SuperwallNotFoundError extends SuperwallError {
-  override readonly name = "SuperwallNotFoundError";
-  readonly url?: string;
-
-  constructor(message: string, opts: { url?: string } = {}) {
-    super(message, "NOT_FOUND");
-    if (opts.url !== undefined) this.url = opts.url;
-  }
-}
-
-export class SuperwallTimeoutError extends SuperwallError {
-  override readonly name = "SuperwallTimeoutError";
-  readonly url?: string;
-  readonly timeoutMs?: number;
-
-  constructor(
-    message: string,
-    opts: { url?: string; timeoutMs?: number } = {},
-  ) {
-    super(message, "TIMEOUT");
-    if (opts.url !== undefined) this.url = opts.url;
-    if (opts.timeoutMs !== undefined) this.timeoutMs = opts.timeoutMs;
-  }
-}
-
-export class SuperwallDecodingError extends SuperwallError {
-  override readonly name = "SuperwallDecodingError";
-  readonly url?: string;
-  override readonly cause?: unknown;
-
-  constructor(
-    message: string,
-    opts: { url?: string; cause?: unknown } = {},
-  ) {
-    super(message, "DECODING");
-    if (opts.url !== undefined) this.url = opts.url;
-    if (opts.cause !== undefined) this.cause = opts.cause;
-  }
-}

package/src/hosts.ts

@@ -1,40 +0,0 @@
-import type { EnvironmentHosts, NetworkEnvironment } from "./types.ts";
-
-const RELEASE_HOSTS: EnvironmentHosts = {
-  base: "api.superwall.me",
-  collector: "collector.superwall.com",
-  enrichment: "enrichment-api.superwall.com",
-  subscriptions: "subscriptions-api.superwall.com",
-};
-
-const RC_HOSTS: EnvironmentHosts = {
-  base: "api.superwallcanary.com",
-  collector: "collector.superwallcanary.com",
-  enrichment: "enrichment-api.superwall.dev",
-  subscriptions: "subscriptions-api.superwall.dev",
-};
-
-const DEV_HOSTS: EnvironmentHosts = {
-  base: "api.superwall.dev",
-  collector: "collector.superwall.com",
-  enrichment: "enrichment-api.superwall.dev",
-  subscriptions: "subscriptions-api.superwall.dev",
-};
-
-export const resolveHosts = (env: NetworkEnvironment): EnvironmentHosts => {
-  if (typeof env === "string") {
-    switch (env) {
-      case "release":
-        return RELEASE_HOSTS;
-      case "releaseCandidate":
-        return RC_HOSTS;
-      case "developer":
-        return DEV_HOSTS;
-    }
-  }
-  return env.custom;
-};
-
-// Custom environments are typically internal proxies → assume production.
-export const isSandbox = (env: NetworkEnvironment): boolean =>
-  typeof env === "string" ? env !== "release" : false;

package/src/index.ts

@@ -1,4 +0,0 @@
-export * from "./types.ts";
-export * from "./hosts.ts";
-export * from "./wire.ts";
-export * from "./errors.ts";

package/src/types.ts

@@ -1,92 +0,0 @@
-// Cross-SDK domain types. Anything shared between @superwall/paywalls-js
-// (browser) and @superwall/server lives here. Browser-only and server-only
-// types stay in their respective packages.
-
-export type JsonValue =
-  | string
-  | number
-  | boolean
-  | null
-  | JsonValue[]
-  | { [key: string]: JsonValue };
-
-// Subscription & entitlements
-
-export type SubscriptionStatus =
-  | { status: "UNKNOWN" }
-  | { status: "INACTIVE" }
-  | { status: "ACTIVE"; entitlements: Entitlement[] };
-
-export type ProductStore =
-  | "appStore"
-  | "stripe"
-  | "paddle"
-  | "playStore"
-  | "superwall"
-  | "other";
-
-export type LatestSubscriptionState =
-  | "inGracePeriod"
-  | "subscribed"
-  | "expired"
-  | "inBillingRetryPeriod"
-  | "revoked";
-
-export type LatestSubscriptionOfferType =
-  | "trial"
-  | "code"
-  | "promotional"
-  | "winback";
-
-export interface Entitlement {
-  id: string;
-  type: "SERVICE_LEVEL";
-  isActive: boolean;
-  productIds: string[];
-  latestProductId?: string;
-  store?: ProductStore;
-  startsAt?: number;
-  renewedAt?: number;
-  expiresAt?: number;
-  isLifetime?: boolean;
-  willRenew?: boolean;
-  state?: LatestSubscriptionState;
-  offerType?: LatestSubscriptionOfferType;
-}
-
-export interface Entitlements {
-  active: Entitlement[];
-  inactive: Entitlement[];
-  all: Entitlement[];
-}
-
-export type PaywallPresentationStyle =
-  | { type: "MODAL" }
-  | { type: "FULLSCREEN" }
-  | { type: "NO_ANIMATION" }
-  | { type: "PUSH" }
-  | { type: "DRAWER"; height: number; cornerRadius: number }
-  | { type: "POPUP"; height: number; width: number; cornerRadius: number }
-  | { type: "NONE" };
-
-// Network environment selector. Both SDKs accept this on construction.
-
-export interface CustomEnvironmentHosts {
-  base: string;
-  collector: string;
-  enrichment: string;
-  subscriptions: string;
-}
-
-export type NetworkEnvironment =
-  | "release"
-  | "releaseCandidate"
-  | "developer"
-  | { custom: CustomEnvironmentHosts };
-
-export interface EnvironmentHosts {
-  readonly base: string;
-  readonly collector: string;
-  readonly enrichment: string;
-  readonly subscriptions: string;
-}

package/src/wire.test.ts

@@ -1,45 +0,0 @@
-import { test, expect } from "bun:test";
-import { parseEntitlements, type WebEntitlementsResponse } from "./wire.ts";
-
-test("parseEntitlements reads the BE `identifier` field (not `id`)", () => {
-  // Real BE shape: customerInfo.entitlements[].identifier + isActive.
-  const res: WebEntitlementsResponse = {
-    entitlements: [],
-    customerInfo: {
-      entitlements: [
-        {
-          identifier: "best",
-          type: "SERVICE_LEVEL",
-          isActive: true,
-          productIds: ["test:price_a", "test:price_b"],
-        },
-      ],
-    },
-  };
-  const out = parseEntitlements(res);
-  expect(out.all).toHaveLength(1);
-  expect(out.all[0]!.id).toBe("best");
-  expect(out.active.map((e) => e.id)).toEqual(["best"]);
-  expect(out.inactive).toHaveLength(0);
-});
-
-test("parseEntitlements: isActive:false → inactive bucket, id still resolved", () => {
-  const res: WebEntitlementsResponse = {
-    customerInfo: {
-      entitlements: [
-        { identifier: "best", isActive: false, productIds: ["p"] },
-      ],
-    },
-  };
-  const out = parseEntitlements(res);
-  expect(out.active).toHaveLength(0);
-  expect(out.inactive[0]!.id).toBe("best");
-});
-
-test("parseEntitlements: legacy `id` field still works", () => {
-  const res: WebEntitlementsResponse = {
-    entitlements: [{ id: "pro", isActive: true, productIds: [] }],
-  };
-  const out = parseEntitlements(res);
-  expect(out.all[0]!.id).toBe("pro");
-});

package/src/wire.ts

@@ -1,58 +0,0 @@
-import type { Entitlement, Entitlements } from "./types.ts";
-
-// Wire shape returned by GET /subscriptions-api/public/v1/users/{id}/entitlements.
-// All fields optional — backend may return either a `customerInfo` envelope
-// or a flat `entitlements` array. Domain types tighten these up.
-export interface WebEntitlementsResponse {
-  readonly customerInfo?: {
-    entitlements?: ReadonlyArray<WireEntitlement>;
-  };
-  readonly entitlements?: ReadonlyArray<WireEntitlement>;
-  /** Short-lived (≈1h) Superwall-signed JWT asserting the active entitlements,
-   *  for offline server-side verification via `@superwall/verify`. Best-effort:
-   *  the backend omits it when signing is unavailable (e.g. no key configured
-   *  in that environment), so treat its absence gracefully. */
-  readonly entitlementsToken?: string;
-}
-
-export interface WireEntitlement {
-  /** BE wire shape uses `identifier`; older/other shapes use `id`. */
-  identifier?: string;
-  id?: string;
-  isActive?: boolean;
-  productIds?: string[];
-  type?: string;
-}
-
-const toDomain = (e: WireEntitlement): Entitlement => ({
-  id: e.identifier ?? e.id ?? "",
-  type: "SERVICE_LEVEL",
-  isActive: e.isActive ?? false,
-  productIds: e.productIds ?? [],
-});
-
-/**
- * Normalize a `WebEntitlementsResponse` into a domain `Entitlements`
- * bucket. Prefers the `entitlements` top-level array if present, falls
- * back to `customerInfo.entitlements`.
- */
-export const parseEntitlements = (
-  res: WebEntitlementsResponse,
-): Entitlements => {
-  // The BE sends `entitlements: []` (empty) at the top level and the real
-  // ones under `customerInfo.entitlements`. A plain `??` would pick the
-  // empty top-level array (it isn't nullish) and drop the real ones — so
-  // only fall back to the top level when customerInfo has nothing.
-  const wire =
-    res.customerInfo?.entitlements && res.customerInfo.entitlements.length > 0
-      ? res.customerInfo.entitlements
-      : res.entitlements && res.entitlements.length > 0
-        ? res.entitlements
-        : (res.customerInfo?.entitlements ?? res.entitlements ?? []);
-  const all = wire.map(toDomain);
-  return {
-    active: all.filter((e) => e.isActive),
-    inactive: all.filter((e) => !e.isActive),
-    all,
-  };
-};

package/tsconfig.json

@@ -1,7 +0,0 @@
-{
-  "extends": "../../tsconfig.base.json",
-  "compilerOptions": {
-    "rootDir": "src"
-  },
-  "include": ["src/**/*"]
-}