@smess/networking 1.2.0 → 2.0.0

package/dist/core/client.js

@@ -0,0 +1,124 @@
+import { parseErrorBody } from '../errors/parse-error-body.js';
+import { SmessApiError, errorKindForStatus, parseRetryAfter } from '../errors/smess-api-error.js';
+import { createAuthMiddleware } from '../session/auth-middleware.js';
+import { decodeJwt } from '../session/jwt.js';
+import { encodeBody } from './body.js';
+import { composeMiddleware } from './pipeline.js';
+import { createRetryMiddleware } from './retry.js';
+import { createFetchTransport } from './transport.js';
+import { buildPath, joinUrl, serializeQuery } from './url.js';
+export const DEFAULT_TIMEOUT_MS = 30000;
+export const DEFAULT_REFRESH_SKEW_MS = 30000;
+function errorFromResponse(response, request) {
+    const parsed = parseErrorBody(response.data);
+    return new SmessApiError({
+        kind: response.status < 400 ? 'invalid_response' : errorKindForStatus(response.status),
+        status: response.status,
+        serverMessage: parsed.message,
+        code: parsed.code,
+        type: parsed.type,
+        param: parsed.param,
+        fields: parsed.fields,
+        retryAfter: parseRetryAfter(response.headers.get('Retry-After')),
+        body: response.data,
+        request,
+    });
+}
+export function createSmessClient(config) {
+    const store = config.session ?? null;
+    const transport = createFetchTransport(config.fetch);
+    const run = composeMiddleware([
+        ...(config.middleware ?? []),
+        ...(config.retry ? [createRetryMiddleware(config.retry)] : []),
+        createAuthMiddleware({
+            store,
+            refresh: config.refresh ?? null,
+            refreshSkewMs: config.refreshSkewMs ?? DEFAULT_REFRESH_SKEW_MS,
+            onSessionExpired: config.onSessionExpired,
+            // Refresh calls go through this same client; resolved lazily, after `client` is defined below.
+            client: () => client,
+        }),
+    ], (context) => transport(context.request));
+    async function execute(spec) {
+        const info = { method: spec.method, url: spec.path, ...(spec.service && { service: spec.service }) };
+        const base = spec.baseUrl ?? (spec.service ? config.hosts[spec.service] : undefined);
+        if (!base) {
+            throw new SmessApiError({ kind: 'config', code: 'missing_host', message: `No host configured for service "${spec.service ?? '?'}".`, request: info });
+        }
+        if (spec.requiresTenant && !config.clientId) {
+            throw new SmessApiError({ kind: 'config', code: 'missing_client_id', message: `${spec.method} ${spec.path} needs a clientId (X-Client-Id).`, request: info });
+        }
+        const responseType = spec.responseType ?? 'json';
+        const headers = new Headers({ Accept: responseType === 'json' ? 'application/json' : '*/*' });
+        for (const [name, value] of Object.entries(config.headers ?? {}))
+            headers.set(name, value);
+        if (config.clientId)
+            headers.set('X-Client-Id', config.clientId);
+        const encoded = encodeBody(spec.body);
+        if (encoded.contentType)
+            headers.set('Content-Type', encoded.contentType);
+        if (spec.idempotencyKey)
+            headers.set('Idempotency-Key', spec.idempotencyKey);
+        for (const [name, value] of Object.entries(spec.headers ?? {}))
+            headers.set(name, value);
+        const request = {
+            method: spec.method,
+            url: joinUrl(base, buildPath(spec.path, spec.pathParams)) + serializeQuery(spec.query),
+            headers,
+            body: encoded.body,
+            replayable: encoded.replayable,
+            signal: spec.signal,
+            timeoutMs: spec.timeoutMs ?? config.timeoutMs ?? DEFAULT_TIMEOUT_MS,
+            responseType,
+            fetchOptions: { ...config.fetchOptions, ...spec.fetchOptions },
+        };
+        const response = await run({
+            endpoint: { service: spec.service, method: spec.method, path: spec.path, auth: spec.auth },
+            request,
+            meta: {},
+        });
+        const finalInfo = { ...info, url: request.url };
+        if (!response.ok)
+            throw errorFromResponse(response, finalInfo);
+        if (response.unparsable) {
+            throw new SmessApiError({ kind: 'invalid_response', status: response.status, message: 'The server did not return JSON.', body: response.data, request: finalInfo });
+        }
+        return spec.decode ? spec.decode(response.data, response) : response.data;
+    }
+    const client = {
+        config,
+        call(endpoint, ...args) {
+            const input = (args[0] ?? {});
+            return execute({
+                ...input,
+                service: endpoint.service,
+                method: endpoint.method,
+                path: endpoint.path,
+                pathParams: input.path,
+                auth: endpoint.auth,
+                requiresTenant: endpoint.requiresTenant,
+                responseType: endpoint.responseType,
+                decode: endpoint.decode,
+            });
+        },
+        request: (raw) => execute(raw),
+        with: (overrides) => createSmessClient({ ...config, ...overrides, headers: { ...config.headers, ...overrides.headers } }),
+        session: {
+            get: async () => (store ? await store.get() : null),
+            set: async (session) => {
+                if (store)
+                    await store.set(session);
+            },
+            clear: async () => {
+                if (store)
+                    await store.clear();
+            },
+            claims: async () => {
+                const session = store ? await store.get() : null;
+                return session ? decodeJwt(session.accessToken) : null;
+            },
+        },
+    };
+    return client;
+}
+//# sourceMappingURL=client.js.map

package/dist/core/client.js.map

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

package/dist/core/decoders.d.ts

@@ -0,0 +1,8 @@
+import type { HttpResponse } from './transport.js';
+/** `{"data": X}` → X. Fails with `invalid_response` when the wrapper is missing. */
+export declare function unwrapData<T>(data: unknown, response: HttpResponse): T;
+/** `{}` / empty body → `undefined`; for endpoints that only acknowledge (`new JsonResponse()` is `{}`). */
+export declare function ignoreBody(): undefined;
+/** `{}` (Symfony's encoding of `JsonResponse(null)`) or an empty body → null; anything else unchanged. */
+export declare function emptyObjectAsNull<T>(data: unknown): T | null;
+//# sourceMappingURL=decoders.d.ts.map

package/dist/core/decoders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decoders.d.ts","sourceRoot":"","sources":["../../src/core/decoders.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAKnD,oFAAoF;AACpF,wBAAgB,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,GAAG,CAAC,CAQtE;AAED,2GAA2G;AAC3G,wBAAgB,UAAU,IAAI,SAAS,CAEtC;AAED,0GAA0G;AAC1G,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,GAAG,CAAC,GAAG,IAAI,CAI5D"}

package/dist/core/decoders.js

@@ -0,0 +1,26 @@
+import { SmessApiError } from '../errors/smess-api-error.js';
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+/** `{"data": X}` → X. Fails with `invalid_response` when the wrapper is missing. */
+export function unwrapData(data, response) {
+    if (isRecord(data) && 'data' in data)
+        return data.data;
+    throw new SmessApiError({
+        kind: 'invalid_response',
+        status: response.status,
+        message: 'Expected a {"data": …} response.',
+        body: data,
+    });
+}
+/** `{}` / empty body → `undefined`; for endpoints that only acknowledge (`new JsonResponse()` is `{}`). */
+export function ignoreBody() {
+    return undefined;
+}
+/** `{}` (Symfony's encoding of `JsonResponse(null)`) or an empty body → null; anything else unchanged. */
+export function emptyObjectAsNull(data) {
+    if (data === undefined || data === null)
+        return null;
+    if (isRecord(data) && Object.keys(data).length === 0)
+        return null;
+    return data;
+}
+//# sourceMappingURL=decoders.js.map

package/dist/core/decoders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decoders.js","sourceRoot":"","sources":["../../src/core/decoders.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAG7D,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAoC,EAAE,CACpE,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAEvE,oFAAoF;AACpF,MAAM,UAAU,UAAU,CAAI,IAAa,EAAE,QAAsB;IACjE,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,MAAM,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC,IAAS,CAAC;IAC5D,MAAM,IAAI,aAAa,CAAC;QACtB,IAAI,EAAE,kBAAkB;QACxB,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,OAAO,EAAE,kCAAkC;QAC3C,IAAI,EAAE,IAAI;KACX,CAAC,CAAC;AACL,CAAC;AAED,2GAA2G;AAC3G,MAAM,UAAU,UAAU;IACxB,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,0GAA0G;AAC1G,MAAM,UAAU,iBAAiB,CAAI,IAAa;IAChD,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACrD,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAClE,OAAO,IAAS,CAAC;AACnB,CAAC"}

package/dist/core/endpoint.d.ts

@@ -0,0 +1,69 @@
+import type { ServiceKey } from './hosts.js';
+import type { HttpResponse } from './transport.js';
+import type { AuthMode, FetchOptions, HttpMethod, QueryParams, ResponseType } from './types.js';
+import type { HasPathParams, PathParams } from './url.js';
+/**
+ * One core-services route, declared as data. Modules are built from these; tests assert them; a later
+ * OpenAPI generator can emit them.
+ */
+export interface Endpoint<P extends string = string, TBody = unknown, TQuery = unknown, TResult = unknown> {
+    readonly service: ServiceKey;
+    readonly method: HttpMethod;
+    /** Absolute path with `{name}` placeholders, e.g. `/v1/campaigns/email/templates/{id}`. */
+    readonly path: P;
+    readonly auth: AuthMode;
+    /** The route rejects requests without `X-Client-Id`; calling it on a client without `clientId` fails fast. */
+    readonly requiresTenant?: boolean;
+    readonly responseType?: ResponseType;
+    /** Turns the response body into the result; default: the parsed body. */
+    readonly decode?: (data: unknown, response: HttpResponse) => TResult;
+    /** Type-only carrier, never set at runtime. */
+    readonly __types?: {
+        readonly body: TBody;
+        readonly query: TQuery;
+        readonly result: TResult;
+    };
+}
+/** A "none" marker for endpoints that take no body or no query. */
+export type None = never;
+/**
+ * Declares an endpoint. Curried so the result/body/query types are explicit while the path literal is
+ * inferred: `defineEndpoint<Template, TemplateInput>()({ service, method: 'POST', path: '/v1/x/{id}', auth })`.
+ */
+export declare const defineEndpoint: <TResult = unknown, TBody = None, TQuery = None>() => <const P extends string>(definition: Omit<Endpoint<P, TBody, TQuery, TResult>, "__types">) => Endpoint<P, TBody, TQuery, TResult>;
+/** Per-call options every request accepts. */
+export interface CallOptions {
+    signal?: AbortSignal;
+    /** Overrides the client's timeout for this call; 0 disables it. */
+    timeoutMs?: number;
+    /** Extra headers; they win over client defaults (but `auth: 'none'` still strips Authorization). */
+    headers?: Readonly<Record<string, string>>;
+    /** Sent as `Idempotency-Key`. Browsers: only on hosts whose CORS config allows the header. */
+    idempotencyKey?: string;
+    fetchOptions?: FetchOptions;
+}
+type PathPart<P extends string> = HasPathParams<P> extends true ? {
+    path: PathParams<P>;
+} : {
+    path?: undefined;
+};
+type BodyPart<B> = [B] extends [never] ? {
+    body?: undefined;
+} : {
+    body: B;
+};
+type QueryPart<Q> = [Q] extends [never] ? {
+    query?: undefined;
+} : {
+    query?: Q;
+};
+export type CallInput<E> = E extends Endpoint<infer P, infer B, infer Q, unknown> ? CallOptions & PathPart<P> & BodyPart<B> & QueryPart<Q> : never;
+export type EndpointResult<E> = E extends Endpoint<string, unknown, unknown, infer R> ? R : never;
+type RequiredKeys<T> = {
+    [K in keyof T]-?: Record<never, never> extends Pick<T, K> ? never : K;
+}[keyof T];
+/** `[input?]` when every input field is optional, `[input]` otherwise. */
+export type CallArgs<E> = [RequiredKeys<CallInput<E>>] extends [never] ? [input?: CallInput<E>] : [input: CallInput<E>];
+export type AnyEndpoint = Endpoint<string, any, any, any>;
+export type { QueryParams };
+//# sourceMappingURL=endpoint.d.ts.map

package/dist/core/endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint.d.ts","sourceRoot":"","sources":["../../src/core/endpoint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAChG,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE1D;;;GAGG;AACH,MAAM,WAAW,QAAQ,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,KAAK,GAAG,OAAO,EAAE,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IACvG,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,2FAA2F;IAC3F,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACjB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,8GAA8G;IAC9G,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IACrC,yEAAyE;IACzE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,KAAK,OAAO,CAAC;IACrE,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;CAC/F;AAED,mEAAmE;AACnE,MAAM,MAAM,IAAI,GAAG,KAAK,CAAC;AAEzB;;;GAGG;AACH,eAAO,MAAM,cAAc,GACxB,OAAO,GAAG,OAAO,EAAE,KAAK,GAAG,IAAI,EAAE,MAAM,GAAG,IAAI,QAC9C,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,YAAY,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,KAAG,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAClH,CAAC;AAEf,8CAA8C;AAC9C,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oGAAoG;IACpG,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3C,8FAA8F;IAC9F,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED,KAAK,QAAQ,CAAC,CAAC,SAAS,MAAM,IAAI,aAAa,CAAC,CAAC,CAAC,SAAS,IAAI,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,CAAA;CAAE,GAAG;IAAE,IAAI,CAAC,EAAE,SAAS,CAAA;CAAE,CAAC;AACjH,KAAK,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG;IAAE,IAAI,CAAC,EAAE,SAAS,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC;AAC5E,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,SAAS,CAAA;CAAE,GAAG;IAAE,KAAK,CAAC,EAAE,CAAC,CAAA;CAAE,CAAC;AAEhF,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,GAC7E,WAAW,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,GACtD,KAAK,CAAC;AAEV,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,CAAC,SAAS,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAElG,KAAK,YAAY,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC;CAAE,CAAC,MAAM,CAAC,CAAC,CAAC;AAE1G,0EAA0E;AAC1E,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AAIxH,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AAE1D,YAAY,EAAE,WAAW,EAAE,CAAC"}

package/dist/core/endpoint.js

@@ -0,0 +1,6 @@
+/**
+ * Declares an endpoint. Curried so the result/body/query types are explicit while the path literal is
+ * inferred: `defineEndpoint<Template, TemplateInput>()({ service, method: 'POST', path: '/v1/x/{id}', auth })`.
+ */
+export const defineEndpoint = () => (definition) => definition;
+//# sourceMappingURL=endpoint.js.map

package/dist/core/endpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint.js","sourceRoot":"","sources":["../../src/core/endpoint.ts"],"names":[],"mappings":"AA2BA;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GACzB,GAAmD,EAAE,CACrD,CAAyB,UAAgE,EAAuC,EAAE,CAChI,UAAU,CAAC"}

package/dist/core/hosts.d.ts

@@ -0,0 +1,25 @@
+/**
+ * core-services is one codebase served on many hosts: every module's routes are bound to a
+ * `%app.<name>_host%` parameter. A service key names one of those hosts; endpoints refer to the key,
+ * never to a URL, so each app maps keys to the environment it talks to.
+ */
+export declare const PRODUCTION_HOSTS: {
+    /** `app.authentication_host`: login, refresh, OTP, password reset. */
+    readonly authentication: "https://auth.smess.vn";
+    /** `app.campaign_api_host`: the smeup.email campaign API (`/v1/campaigns/*`). */
+    readonly campaignApi: "https://api.smess.vn";
+    /** `app.smeup_file_host`: file uploads (`/v1/smeup-files/*`). */
+    readonly smeupFile: "https://api.smess.vn";
+    /** `app.sso_host`: company single sign-on (`/v1/sso/*`). */
+    readonly sso: "https://sso.smess.vn";
+    /** `app.danara_host`: the Danara rentals API. */
+    readonly danara: "https://api.danara.vn";
+    /** `app.mobile_host`: the SMEUp mobile BFF. */
+    readonly mobile: "https://mobile.smess.vn";
+    /** `app.public_api_host`: the API-key public API (`/v1/public/*`). */
+    readonly publicApi: "https://open.smess.vn";
+};
+export type ServiceKey = keyof typeof PRODUCTION_HOSTS;
+/** Base URL per service. A value may carry a path prefix (`https://proxy.example/api`); no trailing slash needed. */
+export type HostMap = Readonly<Partial<Record<ServiceKey, string>>>;
+//# sourceMappingURL=hosts.d.ts.map

package/dist/core/hosts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosts.d.ts","sourceRoot":"","sources":["../../src/core/hosts.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,gBAAgB;IAC3B,sEAAsE;;IAEtE,iFAAiF;;IAEjF,iEAAiE;;IAEjE,4DAA4D;;IAE5D,iDAAiD;;IAEjD,+CAA+C;;IAE/C,sEAAsE;;CAE9D,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,gBAAgB,CAAC;AAEvD,qHAAqH;AACrH,MAAM,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC"}

package/dist/core/hosts.js

@@ -0,0 +1,22 @@
+/**
+ * core-services is one codebase served on many hosts: every module's routes are bound to a
+ * `%app.<name>_host%` parameter. A service key names one of those hosts; endpoints refer to the key,
+ * never to a URL, so each app maps keys to the environment it talks to.
+ */
+export const PRODUCTION_HOSTS = {
+    /** `app.authentication_host`: login, refresh, OTP, password reset. */
+    authentication: 'https://auth.smess.vn',
+    /** `app.campaign_api_host`: the smeup.email campaign API (`/v1/campaigns/*`). */
+    campaignApi: 'https://api.smess.vn',
+    /** `app.smeup_file_host`: file uploads (`/v1/smeup-files/*`). */
+    smeupFile: 'https://api.smess.vn',
+    /** `app.sso_host`: company single sign-on (`/v1/sso/*`). */
+    sso: 'https://sso.smess.vn',
+    /** `app.danara_host`: the Danara rentals API. */
+    danara: 'https://api.danara.vn',
+    /** `app.mobile_host`: the SMEUp mobile BFF. */
+    mobile: 'https://mobile.smess.vn',
+    /** `app.public_api_host`: the API-key public API (`/v1/public/*`). */
+    publicApi: 'https://open.smess.vn',
+};
+//# sourceMappingURL=hosts.js.map

package/dist/core/hosts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosts.js","sourceRoot":"","sources":["../../src/core/hosts.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,sEAAsE;IACtE,cAAc,EAAE,uBAAuB;IACvC,iFAAiF;IACjF,WAAW,EAAE,sBAAsB;IACnC,iEAAiE;IACjE,SAAS,EAAE,sBAAsB;IACjC,4DAA4D;IAC5D,GAAG,EAAE,sBAAsB;IAC3B,iDAAiD;IACjD,MAAM,EAAE,uBAAuB;IAC/B,+CAA+C;IAC/C,MAAM,EAAE,yBAAyB;IACjC,sEAAsE;IACtE,SAAS,EAAE,uBAAuB;CAC1B,CAAC"}

package/dist/core/pagination.d.ts

@@ -0,0 +1,33 @@
+/**
+ * List envelopes are returned exactly as the server sends them: they carry the pagination state.
+ * Single objects wrapped in `{"data": …}` are unwrapped by the modules.
+ */
+/** Stripe-style list (`CampaignListGetDto` and the other new-style modules). */
+export interface ApiList<T> {
+    readonly object: 'list';
+    readonly data: T[];
+    readonly has_more: boolean;
+    /**
+     * Total matching rows where the handler counts them (e.g. audience contacts); many handlers set it to
+     * `data.length` because they return everything.
+     */
+    readonly total_count: number;
+}
+/** Page-number envelope (Danara listings and sales). */
+export interface PagedList<T> {
+    readonly data: T[];
+    readonly meta: {
+        readonly page: number;
+        readonly limit: number;
+        readonly total: number;
+    };
+}
+/**
+ * Walks a cursor-paginated (`limit` + `starting_after`) list item by item.
+ *
+ * ```ts
+ * for await (const r of paginate((after) => email.campaigns.recipients(id, { starting_after: after }), (r) => r.id)) { … }
+ * ```
+ */
+export declare function paginate<T, C extends string | number>(fetchPage: (startingAfter: C | undefined) => Promise<ApiList<T>>, cursorOf: (item: T) => C): AsyncGenerator<T, void, undefined>;
+//# sourceMappingURL=pagination.d.ts.map

package/dist/core/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../src/core/pagination.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,gFAAgF;AAChF,MAAM,WAAW,OAAO,CAAC,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;IACnB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,wDAAwD;AACxD,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;IACnB,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1F;AAED;;;;;;GAMG;AACH,wBAAuB,QAAQ,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,EAC1D,SAAS,EAAE,CAAC,aAAa,EAAE,CAAC,GAAG,SAAS,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAChE,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GACvB,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CASpC"}

package/dist/core/pagination.js

@@ -0,0 +1,23 @@
+/**
+ * List envelopes are returned exactly as the server sends them: they carry the pagination state.
+ * Single objects wrapped in `{"data": …}` are unwrapped by the modules.
+ */
+/**
+ * Walks a cursor-paginated (`limit` + `starting_after`) list item by item.
+ *
+ * ```ts
+ * for await (const r of paginate((after) => email.campaigns.recipients(id, { starting_after: after }), (r) => r.id)) { … }
+ * ```
+ */
+export async function* paginate(fetchPage, cursorOf) {
+    let cursor;
+    for (;;) {
+        const page = await fetchPage(cursor);
+        yield* page.data;
+        const last = page.data[page.data.length - 1];
+        if (!page.has_more || last === undefined)
+            return;
+        cursor = cursorOf(last);
+    }
+}
+//# sourceMappingURL=pagination.js.map

package/dist/core/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../src/core/pagination.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAoBH;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,QAAQ,CAC7B,SAAgE,EAChE,QAAwB;IAExB,IAAI,MAAqB,CAAC;IAC1B,SAAS,CAAC;QACR,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC;QACrC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACjB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO;QACjD,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC"}

package/dist/core/pipeline.d.ts

@@ -0,0 +1,25 @@
+import type { ServiceKey } from './hosts.js';
+import type { HttpResponse, TransportRequest } from './transport.js';
+import type { AuthMode, HttpMethod } from './types.js';
+/** The endpoint a request belongs to, as middleware sees it. */
+export interface EndpointInfo {
+    readonly service: ServiceKey | undefined;
+    readonly method: HttpMethod;
+    /** The path template (`/v1/campaigns/email/templates/{id}`), useful for logging and metrics. */
+    readonly path: string;
+    readonly auth: AuthMode;
+}
+export interface RequestContext {
+    readonly endpoint: EndpointInfo;
+    /** Mutable: middleware may change headers, URL, timeout before calling `next()`. */
+    readonly request: TransportRequest;
+    /** Free-form storage shared by middleware for one call. */
+    readonly meta: Record<string, unknown>;
+}
+/**
+ * Koa-style middleware. Call `next()` to continue (more than once to retry), or return a response to
+ * short-circuit. Throw a `SmessApiError` to fail the call.
+ */
+export type Middleware = (context: RequestContext, next: () => Promise<HttpResponse>) => Promise<HttpResponse>;
+export declare function composeMiddleware(middleware: readonly Middleware[], terminal: (context: RequestContext) => Promise<HttpResponse>): (context: RequestContext) => Promise<HttpResponse>;
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/core/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/core/pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEvD,gEAAgE;AAChE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,gGAAgG;IAChG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,oFAAoF;IACpF,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IACnC,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;AAE/G,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,SAAS,UAAU,EAAE,EACjC,QAAQ,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,YAAY,CAAC,GAC3D,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,YAAY,CAAC,CASpD"}

package/dist/core/pipeline.js

@@ -0,0 +1,12 @@
+export function composeMiddleware(middleware, terminal) {
+    return (context) => {
+        const dispatch = (index) => {
+            const current = middleware[index];
+            if (!current)
+                return terminal(context);
+            return current(context, () => dispatch(index + 1));
+        };
+        return dispatch(0);
+    };
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/core/pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../src/core/pipeline.ts"],"names":[],"mappings":"AA2BA,MAAM,UAAU,iBAAiB,CAC/B,UAAiC,EACjC,QAA4D;IAE5D,OAAO,CAAC,OAAO,EAAE,EAAE;QACjB,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAyB,EAAE;YACxD,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;YAClC,IAAI,CAAC,OAAO;gBAAE,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC;YACvC,OAAO,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;QACrD,CAAC,CAAC;QACF,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC;IACrB,CAAC,CAAC;AACJ,CAAC"}

package/dist/core/retry.d.ts

@@ -0,0 +1,18 @@
+import type { Middleware } from './pipeline.js';
+import type { HttpMethod } from './types.js';
+/**
+ * Opt-in retries for transient failures. Off by default: core-services runs on a small VPS, and blind
+ * retries add load exactly when it is struggling.
+ */
+export interface RetryOptions {
+    /** Extra attempts after the first. */
+    retries: number;
+    /** Default `['GET']`. Only add methods whose endpoints are idempotent. */
+    methods?: readonly HttpMethod[];
+    /** Default 300 ms, doubled each attempt, with jitter. */
+    baseDelayMs?: number;
+    /** Default 5000 ms. A longer `Retry-After` is not waited for: the error is returned instead. */
+    maxDelayMs?: number;
+}
+export declare function createRetryMiddleware(options: RetryOptions): Middleware;
+//# sourceMappingURL=retry.d.ts.map

package/dist/core/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/core/retry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IAChC,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gGAAgG;IAChG,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAmBD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,YAAY,GAAG,UAAU,CAyBvE"}

package/dist/core/retry.js

@@ -0,0 +1,47 @@
+import { SmessApiError, parseRetryAfter } from '../errors/smess-api-error.js';
+const RETRY_STATUSES = new Set([429, 502, 503, 504]);
+function sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted)
+            return reject(new SmessApiError({ kind: 'aborted', cause: signal.reason }));
+        const timer = setTimeout(() => {
+            signal?.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(new SmessApiError({ kind: 'aborted', cause: signal?.reason }));
+        };
+        signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+export function createRetryMiddleware(options) {
+    const methods = new Set(options.methods ?? ['GET']);
+    const base = options.baseDelayMs ?? 300;
+    const max = options.maxDelayMs ?? 5000;
+    return async (context, next) => {
+        const { request } = context;
+        if (options.retries <= 0 || !methods.has(request.method) || !request.replayable)
+            return next();
+        for (let attempt = 0;; attempt++) {
+            const backoff = Math.min(max, base * 2 ** attempt) * (0.5 + Math.random() / 2);
+            try {
+                const response = await next();
+                if (attempt >= options.retries || !RETRY_STATUSES.has(response.status))
+                    return response;
+                const retryAfter = parseRetryAfter(response.headers.get('Retry-After'));
+                const delay = retryAfter === undefined ? backoff : retryAfter * 1000;
+                if (delay > max)
+                    return response;
+                await sleep(delay, request.signal);
+            }
+            catch (error) {
+                const transient = SmessApiError.is(error) && (error.kind === 'network' || error.kind === 'timeout');
+                if (!transient || attempt >= options.retries)
+                    throw error;
+                await sleep(backoff, request.signal);
+            }
+        }
+    };
+}
+//# sourceMappingURL=retry.js.map

package/dist/core/retry.js.map

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

package/dist/core/transport.d.ts

@@ -0,0 +1,30 @@
+import type { FetchFunction, FetchOptions, HttpMethod, ResponseType } from './types.js';
+/** One HTTP exchange, ready to send. Middleware may change any field before calling `next()`. */
+export interface TransportRequest {
+    method: HttpMethod;
+    url: string;
+    headers: Headers;
+    body?: BodyInit;
+    /** False when the body is a one-shot stream: retries are then skipped. */
+    replayable: boolean;
+    signal?: AbortSignal;
+    /** 0 or undefined disables the timeout. */
+    timeoutMs?: number;
+    responseType: ResponseType;
+    fetchOptions?: FetchOptions;
+}
+/** A response with its body already read (any status; errors are decided by the client layer). */
+export interface HttpResponse {
+    readonly status: number;
+    readonly ok: boolean;
+    readonly headers: Headers;
+    readonly url: string;
+    /** Parsed JSON, raw text (when not JSON), a Blob (`responseType: 'blob'` on 2xx), or undefined (empty body). */
+    readonly data: unknown;
+    /** True when `responseType` is `json` but the body was not valid JSON (`data` then holds the text). */
+    readonly unparsable: boolean;
+}
+export type Transport = (request: TransportRequest) => Promise<HttpResponse>;
+/** The default transport, on the platform `fetch` (browsers, Node 20+, Next.js server and edge, React Native). */
+export declare function createFetchTransport(fetchImpl?: FetchFunction): Transport;
+//# sourceMappingURL=transport.d.ts.map

package/dist/core/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/core/transport.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAExF,iGAAiG;AACjG,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,UAAU,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,0EAA0E;IAC1E,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,YAAY,CAAC;IAC3B,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED,kGAAkG;AAClG,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,gHAAgH;IAChH,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,uGAAuG;IACvG,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;AAoC7E,kHAAkH;AAClH,wBAAgB,oBAAoB,CAAC,SAAS,CAAC,EAAE,aAAa,GAAG,SAAS,CA2BzE"}

package/dist/core/transport.js

@@ -0,0 +1,73 @@
+import { SmessApiError } from '../errors/smess-api-error.js';
+const TIMEOUT = Symbol('smess-timeout');
+function linkSignals(signal, timeoutMs) {
+    const controller = new AbortController();
+    let timer;
+    const onAbort = () => controller.abort(signal?.reason);
+    if (signal?.aborted)
+        controller.abort(signal.reason);
+    else
+        signal?.addEventListener('abort', onAbort, { once: true });
+    if (timeoutMs && timeoutMs > 0 && !controller.signal.aborted) {
+        timer = setTimeout(() => controller.abort(TIMEOUT), timeoutMs);
+    }
+    return {
+        signal: controller.signal,
+        timedOut: () => controller.signal.aborted && controller.signal.reason === TIMEOUT,
+        cleanup: () => {
+            if (timer !== undefined)
+                clearTimeout(timer);
+            signal?.removeEventListener('abort', onAbort);
+        },
+    };
+}
+async function readBody(response, responseType) {
+    if (response.ok && responseType === 'blob')
+        return { data: await response.blob(), unparsable: false };
+    const raw = await response.text();
+    if (responseType === 'text' && response.ok)
+        return { data: raw, unparsable: false };
+    if (raw.trim() === '')
+        return { data: undefined, unparsable: false };
+    // Parse whatever the Content-Type says: some core subscribers send JSON without `application/json`.
+    try {
+        return { data: JSON.parse(raw), unparsable: false };
+    }
+    catch {
+        return { data: raw, unparsable: true };
+    }
+}
+/** The default transport, on the platform `fetch` (browsers, Node 20+, Next.js server and edge, React Native). */
+export function createFetchTransport(fetchImpl) {
+    return async (request) => {
+        // Resolve at call time and call unbound-safe: `window.fetch` throws "Illegal invocation" when detached.
+        const doFetch = fetchImpl ?? ((input, init) => globalThis.fetch(input, init));
+        const link = linkSignals(request.signal, request.timeoutMs);
+        const info = { method: request.method, url: request.url };
+        try {
+            const response = await doFetch(request.url, {
+                ...request.fetchOptions,
+                method: request.method,
+                headers: request.headers,
+                body: request.body ?? null,
+                signal: link.signal,
+            });
+            const { data, unparsable } = await readBody(response, request.responseType);
+            return { status: response.status, ok: response.ok, headers: response.headers, url: response.url || request.url, data, unparsable };
+        }
+        catch (cause) {
+            if (SmessApiError.is(cause))
+                throw cause;
+            if (link.timedOut()) {
+                throw new SmessApiError({ kind: 'timeout', message: `Request timed out after ${request.timeoutMs} ms.`, request: info, cause });
+            }
+            if (link.signal.aborted)
+                throw new SmessApiError({ kind: 'aborted', request: info, cause });
+            throw new SmessApiError({ kind: 'network', request: info, cause });
+        }
+        finally {
+            link.cleanup();
+        }
+    };
+}
+//# sourceMappingURL=transport.js.map