@astroway/sdk 0.1.0-alpha.2 → 1.0.0

package/dist/testing.js

@@ -0,0 +1,132 @@
+/**
+ * Mock client for testing — drop-in replacement for `Astroway` that records
+ * all calls and returns scripted fixtures with zero HTTP traffic.
+ *
+ * ```ts
+ * import { MockAstroway } from '@astroway/sdk/testing';
+ *
+ * const mock = new MockAstroway();
+ * mock.respond('POST', '/chart', { angles: { asc: 'Aries' } });
+ *
+ * const r = await mock.charts.natal({ date: '1990-07-14', ... });
+ * expect(r.angles.asc).toBe('Aries');
+ * expect(mock.calls).toHaveLength(1);
+ * expect(mock.calls[0]).toMatchObject({ method: 'POST', path: '/chart' });
+ * ```
+ *
+ * Why this is its own subpath (`@astroway/sdk/testing`)? It pulls in zero
+ * test-framework deps but ships fixtures + bookkeeping that production code
+ * doesn't need. Tree-shakable — Vitest/Jest-only paths stay out of your
+ * production bundle if your bundler honours `exports`.
+ */
+import { ApiError, classifyHttpError } from './errors.js';
+import { buildNamespaces } from './namespaces.generated.js';
+/**
+ * Wrap an error code/status to make a fixture throw a classified ApiError —
+ * useful for testing user-facing error handling without spinning up a server.
+ *
+ * ```ts
+ * mock.respond('POST', '/chart', mockApiError({ status: 401, code: 'INVALID_API_KEY' }));
+ * await expect(mock.charts.natal(body)).rejects.toThrow(AuthenticationError);
+ * ```
+ */
+export function mockApiError(opts) {
+    return () => {
+        throw classifyHttpError({
+            status: opts.status,
+            ...(opts.code !== undefined ? { code: opts.code } : {}),
+            message: opts.message ?? `${opts.status} (mock)`,
+            ...(opts.body !== undefined ? { body: opts.body } : {}),
+            ...(opts.requestId !== undefined ? { requestId: opts.requestId } : {}),
+            ...(opts.retryAfterSeconds !== undefined ? { retryAfterSeconds: opts.retryAfterSeconds } : {}),
+            ...(opts.creditsRemaining !== undefined ? { creditsRemaining: opts.creditsRemaining } : {}),
+        });
+    };
+}
+const NOT_FOUND = Symbol('mock-fixture-not-found');
+export class MockAstroway {
+    /** All calls observed, in order. Cleared by {@link reset}. */
+    calls = [];
+    fixtures = [];
+    callCounter = 0;
+    /**
+     * The same `client` shape `Astroway` exposes — `client.POST(path, init)`,
+     * `client.GET(path, init)`, etc. Returns `{ data, error?, response }` so
+     * existing namespace code works unchanged.
+     */
+    client;
+    constructor() {
+        const dispatch = async (method, path, init) => {
+            const body = init?.body ?? init?.params ?? null;
+            const headers = init?.headers ?? {};
+            const ctx = {
+                method,
+                path,
+                body,
+                callIndex: this.callCounter++,
+            };
+            const fixture = this.findFixture(method, path);
+            if (fixture === NOT_FOUND) {
+                throw new ApiError(`MockAstroway: no fixture for ${method} ${path}. Use mock.respond('${method}', '${path}', ...) before the call.`);
+            }
+            let resolved;
+            try {
+                resolved = typeof fixture === 'function'
+                    ? await fixture(ctx)
+                    : fixture;
+            }
+            catch (e) {
+                // Record the call before re-raising so users can still inspect what was attempted.
+                this.calls.push({ method, path, body, headers, resolved: e });
+                throw e;
+            }
+            this.calls.push({ method, path, body, headers, resolved });
+            // Wrap as `{ ok, data }` so namespace's envelope-unwrap returns the bare value.
+            return {
+                data: { ok: true, data: resolved },
+                response: new Response(null, { status: 200, headers: { 'x-astroway-mock': 'hit' } }),
+            };
+        };
+        this.client = {
+            POST: ((path, init) => dispatch('POST', path, init)),
+            GET: ((path, init) => dispatch('GET', path, init)),
+            PUT: ((path, init) => dispatch('PUT', path, init)),
+            DELETE: ((path, init) => dispatch('DELETE', path, init)),
+        };
+        Object.assign(this, buildNamespaces(this.client));
+    }
+    /**
+     * Register a fixture. The first un-consumed match wins per call. Repeated
+     * calls re-use the fixture by default — use a factory if you want different
+     * responses across calls.
+     */
+    respond(method, path, fixture) {
+        this.fixtures.push({ method: method.toUpperCase(), path, fixture: fixture, matched: 0 });
+        return this;
+    }
+    /** Reset call log + fixture counters. Useful in `beforeEach`. */
+    reset() {
+        this.calls.length = 0;
+        this.fixtures.length = 0;
+        this.callCounter = 0;
+    }
+    /** Number of calls recorded so far. */
+    get callCount() {
+        return this.calls.length;
+    }
+    /** Find calls matching a path (and optionally method). Useful for assertions. */
+    callsFor(path, method) {
+        const m = method?.toUpperCase();
+        return this.calls.filter((c) => c.path === path && (m === undefined || c.method === m));
+    }
+    findFixture(method, path) {
+        for (const route of this.fixtures) {
+            if (route.method === method.toUpperCase() && route.path === path) {
+                route.matched += 1;
+                return route.fixture;
+            }
+        }
+        return NOT_FOUND;
+    }
+}
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

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