@molecule/app-http 1.0.0

package/dist/unwrap.js

@@ -0,0 +1,221 @@
+/**
+ * Response-envelope unwrappers.
+ *
+ * Apps and mock servers commonly return either a bare value (`T` or
+ * `T[]`) or an envelope `{ data: T }` / `{ data: T[] }`. These helpers
+ * normalize either shape into a predictable `T[]` or `T | null` for
+ * downstream code, eliminating the per-call `'data' in res ? ...` dance.
+ *
+ * Lifted out of the 59 apps that previously carried a local
+ * `lib/unwrap.ts` copy. The two functions cover the response shapes used
+ * by the molecule mock server and the typical resource routes — a bare
+ * value, a `{ data }` envelope, and (for lists) the RICH pagination
+ * envelope `{ data, total, limit, offset }` returned by the pre-built
+ * `@molecule/api-resource-*` list endpoints (comment, review,
+ * activity-feed, bookmark, …). Other bespoke envelopes are out of scope
+ * — handle those in the caller.
+ *
+ * @module
+ */
+/**
+ * Normalize an unknown response body into a typed array.
+ *
+ * Accepts:
+ *   - a bare array → returned as-is (cast)
+ *   - `{ data: T[] }` envelope → the inner array
+ *   - `HttpResponse<T[]>` (i.e. `{ data: T[], status, ... }`) → the inner array
+ *   - `HttpResponse<{ data: T[] }>` (the response of an envelope-returning
+ *     endpoint as it arrives from `@molecule/app-http`'s `HttpClient`) → the
+ *     doubly-nested inner array
+ *   - `HttpResponse<{ data: T[], total, limit, offset }>` (a RICH pagination
+ *     envelope from a pre-built `@molecule/api-resource-*` list endpoint) → the
+ *     inner `data` array (the numeric `total`/`limit`/`offset` make the shape
+ *     unambiguous, so callers can pass the whole HttpResponse and still get the rows)
+ *   - anything else → `[]`
+ *
+ * Callers commonly pass either the raw JSON body (e.g. from `fetch().then(r =>
+ * r.json())`) or the `HttpResponse` returned by `useHttpClient().get(...)`.
+ * Both shapes are handled here so pages don't have to remember to call
+ * `unwrapList(res.data)` vs `unwrapList(res)`.
+ *
+ * @param res - Raw response body OR an `HttpResponse` envelope from `@molecule/app-http`.
+ * @returns A typed array `T[]`; never `null`/`undefined`.
+ */
+export function unwrapList(res) {
+    if (Array.isArray(res))
+        return res;
+    if (res && typeof res === 'object' && 'data' in res) {
+        const inner = res.data;
+        if (Array.isArray(inner))
+            return inner;
+        // `HttpResponse<{ data: T[] }>` — caller passed the whole response object
+        // (typeof `{ data, status, statusText, headers, config }`) and the inner
+        // JSON body is itself an envelope `{ data: T[] }`. Peel both layers, but
+        // only when the outer shape is unambiguously an `HttpResponse` (i.e. has
+        // the `status: number` field), so we don't mis-peel application objects.
+        if (isHttpResponseLike(res) &&
+            inner &&
+            typeof inner === 'object' &&
+            // Only a PURE single-key `{ data: T[] }` envelope is a double-wrap to peel.
+            // A resource that legitimately carries its own `data` array field
+            // (`{ id, …, data: [...] }`) has >1 key — peeling it would return the
+            // resource's own array and drop the surrounding fields.
+            Object.keys(inner).length === 1 &&
+            'data' in inner &&
+            Array.isArray(inner.data)) {
+            return inner.data;
+        }
+        // `HttpResponse<PaginatedResult<T>>` — the pre-built `@molecule/api-resource-*`
+        // list endpoints return a RICH pagination envelope `{ data: T[], total, limit,
+        // offset }`. It has >1 key so the pure-`{ data }` branch above skips it, but the
+        // shape is unambiguous: a `data` array alongside numeric `total`, `limit`, AND
+        // `offset` is a pagination result, not an application object. Restricted to the
+        // HttpResponse case so a plain body is never second-guessed.
+        if (isHttpResponseLike(res) && isPaginationEnvelope(inner)) {
+            return inner.data;
+        }
+    }
+    return [];
+}
+/**
+ * Metadata keys a list endpoint may carry alongside its `data` array.
+ *
+ * Covers both conventions in this fleet: `PaginatedResult` from the pre-built
+ * `@molecule/api-resource-*` endpoints (`total`/`limit`/`offset`) and the
+ * `page`/`limit` form hand-written handlers use.
+ */
+const PAGINATION_KEYS = new Set([
+    'total',
+    'limit',
+    'offset',
+    'page',
+    'pageSize',
+    'per_page',
+    'perPage',
+    'count',
+    // An aggregate OVER the collection, in the same family as `total`/`count` —
+    // seven flagships' notification lists answer `{ data, unreadCount, total }`.
+    // The criterion for membership here is that the key describes the list rather
+    // than belonging to a resource: no notification row carries `unreadCount`, so
+    // this stays unambiguous. App-specific aggregates that don't meet that bar
+    // belong under `meta`.
+    'unreadCount',
+    'unread_count',
+    'hasMore',
+    'has_more',
+    'cursor',
+    'nextCursor',
+    'next_cursor',
+    'meta',
+    'links',
+]);
+/**
+ * Recognise a list envelope: a `data` array plus only pagination metadata.
+ *
+ * @param v - The inner JSON body of an `HttpResponse`.
+ * @returns True when `v` is a paginated list rather than an application object.
+ */
+function isPaginationEnvelope(v) {
+    if (!v || typeof v !== 'object')
+        return false;
+    if (!Array.isArray(v.data))
+        return false;
+    // Every OTHER key must be recognised pagination metadata. Requiring the exact
+    // trio total+limit+offset — as this did — missed `{ data, page, limit }`, the
+    // shape hand-written list handlers return, and unwrapList then answered `[]`
+    // for a response carrying 20 rows. That is the worst possible failure mode
+    // here: silent, and indistinguishable from an empty collection, so a
+    // storefront rendered zero products with no error anywhere.
+    //
+    // Membership is still what keeps this unambiguous. An application object that
+    // merely owns a `data` array carries domain keys (`id`, `name`, …), none of
+    // which are in this set, so it is never mistaken for an envelope.
+    return Object.keys(v).every((k) => k === 'data' || PAGINATION_KEYS.has(k));
+}
+/**
+ * Recognise an `HttpResponse` from `@molecule/app-http` without taking a
+ * runtime dependency on its types: an object with both `data` and a numeric
+ * `status` field. Plain API JSON bodies don't include `status`, so the check
+ * is unambiguous.
+ */
+function isHttpResponseLike(res) {
+    return (!!res &&
+        typeof res === 'object' &&
+        'data' in res &&
+        'status' in res &&
+        typeof res.status === 'number');
+}
+/**
+ * Normalize an unknown response body into a single typed resource.
+ *
+ * Accepts:
+ *   - a non-empty plain object → returned as-is (cast)
+ *   - `{ data: T }` envelope → the inner value
+ *   - `{ data: null }`, `{ data: undefined }`, `{ data: [] }`, or
+ *     `{ data: {} }` (mock-server's no-match shape) → `null`
+ *   - an empty object `{}` → `null`
+ *   - arrays, primitives, `null`, `undefined` → `null`
+ *
+ * The "envelope contains an array → null" branch handles the case
+ * where the mock server returns `[]` for unmatched endpoints but the
+ * caller expects a single resource.
+ *
+ * @param res - Raw response body (e.g. `HttpResponse.data` from `@molecule/app-http`).
+ * @returns The typed resource `T`, or `null` when the response shape
+ *   indicates "no resource" (including the various empty envelopes
+ *   above).
+ */
+export function unwrapSingle(res) {
+    if (res && typeof res === 'object' && !Array.isArray(res)) {
+        // A resource may legitimately OWN a `data` field. grocery-delivery's
+        // GET /api/cart answers `{ data: [...], items: [...], subtotal, delivery_fee,
+        // … }` — a cart object that happens to carry its rows under `data` as well.
+        // Peeling that returned the inner array, which the "caller wants a single
+        // resource" branch below then turned into `null`, so the cart page rendered
+        // empty while the API held the item and 20 tests failed on the empty page
+        // instead of the cause. Only peel when the object is a PURE envelope: `data`
+        // plus recognised pagination metadata and nothing else. (isPaginationEnvelope
+        // covers the array case; the object case is guarded the same way here.)
+        const looksLikeResource = !isHttpResponseLike(res) &&
+            Object.keys(res).some((k) => k !== 'data' && !PAGINATION_KEYS.has(k));
+        if ('data' in res && !looksLikeResource) {
+            const inner = res.data;
+            if (inner === null || inner === undefined)
+                return null;
+            // Caller expects a single resource. If the envelope contains an array
+            // (mock-server returns [] for unmatched endpoints), treat as missing.
+            if (Array.isArray(inner))
+                return null;
+            if (typeof inner === 'object') {
+                const innerObj = inner;
+                // `HttpResponse<{ data: T }>` — caller passed the whole HttpResponse
+                // (recognisable by the `status: number` sibling on `res`) and the
+                // inner JSON body is itself an envelope `{ data: T }`. Peel the second
+                // layer. We restrict this to the HttpResponse case so plain payloads
+                // shaped `{ data: { data: ... } }` keep their existing semantics.
+                if (isHttpResponseLike(res) &&
+                    // Only a PURE single-key `{ data: T }` envelope is a double-wrap to
+                    // peel. A resource that legitimately carries its own `data` object
+                    // field (`{ id, …, data: {…} }`) has >1 key — peeling it would drop
+                    // id and the sibling fields, silently corrupting the resource.
+                    Object.keys(innerObj).length === 1 &&
+                    'data' in innerObj &&
+                    innerObj.data !== null &&
+                    innerObj.data !== undefined &&
+                    typeof innerObj.data === 'object' &&
+                    !Array.isArray(innerObj.data) &&
+                    Object.keys(innerObj.data).length > 0) {
+                    return innerObj.data;
+                }
+                if (Object.keys(innerObj).length === 0)
+                    return null;
+            }
+            return inner;
+        }
+        if (Object.keys(res).length === 0)
+            return null;
+        return res;
+    }
+    return null;
+}
+//# sourceMappingURL=unwrap.js.map

package/dist/unwrap.js.map

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

package/dist/utilities.d.ts

@@ -0,0 +1,79 @@
+/**
+ * HTTP bond accessor and convenience request functions.
+ *
+ * If no custom client is bonded, a fetch-based client is auto-created
+ * on first access. Provides `get`, `post`, `put`, `patch`, and `del`
+ * shorthand functions that delegate to the bonded client.
+ *
+ * @module
+ */
+import type { HttpClient } from './client.js';
+import type { HttpResponse, RequestConfig } from './types.js';
+/**
+ * Registers an HTTP client as the active singleton.
+ *
+ * @param client - The HTTP client implementation to bond.
+ *
+ * @example
+ * ```typescript
+ * import { setClient, createFetchClient } from '@molecule/app-http'
+ * setClient(createFetchClient({ baseURL: 'https://api.example.com' }))
+ * ```
+ */
+export declare const setClient: (client: HttpClient) => void;
+/**
+ * Retrieves the bonded HTTP client. If none is bonded, automatically
+ * creates a default fetch-based client.
+ *
+ * @returns The active HTTP client instance.
+ */
+export declare const getClient: () => HttpClient;
+/**
+ * Makes a GET request using the bonded HTTP client.
+ *
+ * @param url - The request URL (relative to baseURL if configured).
+ * @param config - Optional request configuration (headers, params, timeout).
+ * @returns The HTTP response with typed data.
+ */
+export declare const get: <T = unknown>(url: string, config?: RequestConfig) => Promise<HttpResponse<T>>;
+/**
+ * Makes a POST request using the bonded HTTP client.
+ *
+ * @param url - The request URL.
+ * @param data - The request body.
+ * @param config - Optional request configuration.
+ * @returns The HTTP response with typed data.
+ */
+export declare const post: <T = unknown>(url: string, data?: unknown, config?: RequestConfig) => Promise<HttpResponse<T>>;
+/**
+ * Makes a PUT request using the bonded HTTP client.
+ *
+ * @param url - The request URL.
+ * @param data - The request body.
+ * @param config - Optional request configuration.
+ * @returns The HTTP response with typed data.
+ */
+export declare const put: <T = unknown>(url: string, data?: unknown, config?: RequestConfig) => Promise<HttpResponse<T>>;
+/**
+ * Makes a PATCH request using the bonded HTTP client.
+ *
+ * @param url - The request URL.
+ * @param data - The request body (partial update).
+ * @param config - Optional request configuration.
+ * @returns The HTTP response with typed data.
+ */
+export declare const patch: <T = unknown>(url: string, data?: unknown, config?: RequestConfig) => Promise<HttpResponse<T>>;
+/**
+ * Makes a DELETE request using the bonded HTTP client.
+ *
+ * @param url - The request URL.
+ * @param config - Optional request configuration.
+ * @returns The HTTP response with typed data.
+ */
+export declare const del: <T = unknown>(url: string, config?: RequestConfig) => Promise<HttpResponse<T>>;
+/**
+ * Pre-created fetch client for environments where `fetch` is available.
+ * `null` in environments without a global `fetch`.
+ */
+export declare const fetchClient: HttpClient | null;
+//# sourceMappingURL=utilities.d.ts.map

package/dist/utilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utilities.d.ts","sourceRoot":"","sources":["../src/utilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE7C,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAI7D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,SAAS,GAAI,QAAQ,UAAU,KAAG,IAE9C,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,SAAS,QAAO,UAM5B,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,GAAG,GAAI,CAAC,GAAG,OAAO,EAAE,KAAK,MAAM,EAAE,SAAS,aAAa,KAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAC7D,CAAA;AAEjC;;;;;;;GAOG;AACH,eAAO,MAAM,IAAI,GAAI,CAAC,GAAG,OAAO,EAC9B,KAAK,MAAM,EACX,OAAO,OAAO,EACd,SAAS,aAAa,KACrB,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAA2C,CAAA;AAErE;;;;;;;GAOG;AACH,eAAO,MAAM,GAAG,GAAI,CAAC,GAAG,OAAO,EAC7B,KAAK,MAAM,EACX,OAAO,OAAO,EACd,SAAS,aAAa,KACrB,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAA0C,CAAA;AAEpE;;;;;;;GAOG;AACH,eAAO,MAAM,KAAK,GAAI,CAAC,GAAG,OAAO,EAC/B,KAAK,MAAM,EACX,OAAO,OAAO,EACd,SAAS,aAAa,KACrB,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAA4C,CAAA;AAEtE;;;;;;GAMG;AACH,eAAO,MAAM,GAAG,GAAI,CAAC,GAAG,OAAO,EAAE,KAAK,MAAM,EAAE,SAAS,aAAa,KAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAC1D,CAAA;AAEpC;;;GAGG;AACH,eAAO,MAAM,WAAW,mBAA4D,CAAA"}

package/dist/utilities.js

@@ -0,0 +1,89 @@
+/**
+ * HTTP bond accessor and convenience request functions.
+ *
+ * If no custom client is bonded, a fetch-based client is auto-created
+ * on first access. Provides `get`, `post`, `put`, `patch`, and `del`
+ * shorthand functions that delegate to the bonded client.
+ *
+ * @module
+ */
+import { bond, get as bondGet } from '@molecule/app-bond';
+import { createFetchClient } from './provider.js';
+const BOND_TYPE = 'http-client';
+/**
+ * Registers an HTTP client as the active singleton.
+ *
+ * @param client - The HTTP client implementation to bond.
+ *
+ * @example
+ * ```typescript
+ * import { setClient, createFetchClient } from '@molecule/app-http'
+ * setClient(createFetchClient({ baseURL: 'https://api.example.com' }))
+ * ```
+ */
+export const setClient = (client) => {
+    bond(BOND_TYPE, client);
+};
+/**
+ * Retrieves the bonded HTTP client. If none is bonded, automatically
+ * creates a default fetch-based client.
+ *
+ * @returns The active HTTP client instance.
+ */
+export const getClient = () => {
+    const existing = bondGet(BOND_TYPE);
+    if (existing)
+        return existing;
+    const fallback = createFetchClient();
+    bond(BOND_TYPE, fallback);
+    return fallback;
+};
+/**
+ * Makes a GET request using the bonded HTTP client.
+ *
+ * @param url - The request URL (relative to baseURL if configured).
+ * @param config - Optional request configuration (headers, params, timeout).
+ * @returns The HTTP response with typed data.
+ */
+export const get = (url, config) => getClient().get(url, config);
+/**
+ * Makes a POST request using the bonded HTTP client.
+ *
+ * @param url - The request URL.
+ * @param data - The request body.
+ * @param config - Optional request configuration.
+ * @returns The HTTP response with typed data.
+ */
+export const post = (url, data, config) => getClient().post(url, data, config);
+/**
+ * Makes a PUT request using the bonded HTTP client.
+ *
+ * @param url - The request URL.
+ * @param data - The request body.
+ * @param config - Optional request configuration.
+ * @returns The HTTP response with typed data.
+ */
+export const put = (url, data, config) => getClient().put(url, data, config);
+/**
+ * Makes a PATCH request using the bonded HTTP client.
+ *
+ * @param url - The request URL.
+ * @param data - The request body (partial update).
+ * @param config - Optional request configuration.
+ * @returns The HTTP response with typed data.
+ */
+export const patch = (url, data, config) => getClient().patch(url, data, config);
+/**
+ * Makes a DELETE request using the bonded HTTP client.
+ *
+ * @param url - The request URL.
+ * @param config - Optional request configuration.
+ * @returns The HTTP response with typed data.
+ */
+export const del = (url, config) => getClient().delete(url, config);
+/**
+ * Pre-created fetch client for environments where `fetch` is available.
+ * `null` in environments without a global `fetch`.
+ */
+export const fetchClient = typeof fetch !== 'undefined' ? createFetchClient() : null;
+//# sourceMappingURL=utilities.js.map

package/dist/utilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utilities.js","sourceRoot":"","sources":["../src/utilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,IAAI,EAAE,GAAG,IAAI,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAGzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAGjD,MAAM,SAAS,GAAG,aAAa,CAAA;AAE/B;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,MAAkB,EAAQ,EAAE;IACpD,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;AACzB,CAAC,CAAA;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,GAAe,EAAE;IACxC,MAAM,QAAQ,GAAG,OAAO,CAAa,SAAS,CAAC,CAAA;IAC/C,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAA;IAC7B,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAA;IACpC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;IACzB,OAAO,QAAQ,CAAA;AACjB,CAAC,CAAA;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,CAAc,GAAW,EAAE,MAAsB,EAA4B,EAAE,CAChG,SAAS,EAAE,CAAC,GAAG,CAAI,GAAG,EAAE,MAAM,CAAC,CAAA;AAEjC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,CAClB,GAAW,EACX,IAAc,EACd,MAAsB,EACI,EAAE,CAAC,SAAS,EAAE,CAAC,IAAI,CAAI,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;AAErE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,CACjB,GAAW,EACX,IAAc,EACd,MAAsB,EACI,EAAE,CAAC,SAAS,EAAE,CAAC,GAAG,CAAI,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;AAEpE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CACnB,GAAW,EACX,IAAc,EACd,MAAsB,EACI,EAAE,CAAC,SAAS,EAAE,CAAC,KAAK,CAAI,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;AAEtE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,CAAc,GAAW,EAAE,MAAsB,EAA4B,EAAE,CAChG,SAAS,EAAE,CAAC,MAAM,CAAI,GAAG,EAAE,MAAM,CAAC,CAAA;AAEpC;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,KAAK,KAAK,WAAW,CAAC,CAAC,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@molecule/app-http",
+  "version": "1.0.0",
+  "description": "Client HTTP interface for molecule.dev",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "molecule",
+    "http",
+    "api-client",
+    "fetch"
+  ],
+  "license": "Apache-2.0",
+  "peerDependencies": {
+    "@molecule/app-bond": "^1.0.0",
+    "@molecule/app-i18n": "^1.0.0",
+    "@molecule/app-logger": "^1.0.0"
+  },
+  "devDependencies": {
+    "@molecule/app-bond": "1.0.0",
+    "@molecule/app-i18n": "1.0.0",
+    "@molecule/app-logger": "1.0.0",
+    "@types/node": "26.1.2",
+    "typescript": "6.0.3",
+    "vitest": "4.1.10"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/molecule-dev/molecule.git",
+    "directory": "packages/app/core/http"
+  },
+  "homepage": "https://github.com/molecule-dev/molecule/tree/main/packages/app/core/http",
+  "bugs": "https://github.com/molecule-dev/molecule/issues",
+  "publishConfig": {
+    "access": "public"
+  }
+}