@dugjason/front-node 0.1.0-beta.2 → 0.2.0

package/dist/core/errors.js

@@ -1,124 +0,0 @@
-/**
- * Base Front SDK error. All SDK errors extend this class.
- */
-export class FrontError extends Error {
-    status;
-    code;
-    details;
-    headers;
-    constructor(message, status, code, details, headers) {
-        super(message);
-        this.status = status;
-        this.code = code;
-        this.details = details;
-        this.headers = headers;
-        this.name = "FrontError";
-    }
-}
-/** 400 Bad Request */
-export class FrontBadRequestError extends FrontError {
-    constructor(...args) {
-        super(...args);
-        this.name = "FrontBadRequestError";
-    }
-}
-/** 401 Unauthorized */
-export class FrontUnauthorizedError extends FrontError {
-    constructor(...args) {
-        super(...args);
-        this.name = "FrontUnauthorizedError";
-    }
-}
-/** 403 Forbidden */
-export class FrontForbiddenError extends FrontError {
-    constructor(...args) {
-        super(...args);
-        this.name = "FrontForbiddenError";
-    }
-}
-/** 404 Not Found */
-export class FrontNotFoundError extends FrontError {
-    constructor(...args) {
-        super(...args);
-        this.name = "FrontNotFoundError";
-    }
-}
-/** 409 Conflict */
-export class FrontConflictError extends FrontError {
-    constructor(...args) {
-        super(...args);
-        this.name = "FrontConflictError";
-    }
-}
-/** 422 Unprocessable Entity */
-export class FrontUnprocessableEntityError extends FrontError {
-    constructor(...args) {
-        super(...args);
-        this.name = "FrontUnprocessableEntityError";
-    }
-}
-/** 429 Too Many Requests */
-export class FrontRateLimitError extends FrontError {
-    constructor(...args) {
-        super(...args);
-        this.name = "FrontRateLimitError";
-    }
-}
-/** 5xx Server Error */
-export class FrontServerError extends FrontError {
-    constructor(...args) {
-        super(...args);
-        this.name = "FrontServerError";
-    }
-}
-/**
- * Normalize unknown errors (thrown by fetch/generated client) into FrontError subclasses.
- *
- * - Preserves HTTP status and headers when available
- * - Attempts to read `message` and `code` from the thrown payload
- * - Maps common HTTP status codes to specific subclasses for easier matching
- *
- * @param error - The unknown error payload (string/object/Error)
- * @param response - The corresponding `Response`, if available
- * @returns A typed `FrontError` subclass
- */
-export function mapToFrontError(error, response) {
-    // error could be a string, object, or already an Error/FrontError
-    if (error instanceof FrontError)
-        return error;
-    console.log("error >", error);
-    const status = response?.status;
-    const headers = response?.headers;
-    console.log("headers >", headers);
-    const maybeObj = error;
-    const code = typeof maybeObj === "object" &&
-        maybeObj &&
-        typeof maybeObj.code === "string"
-        ? maybeObj.code
-        : undefined;
-    const message = typeof maybeObj === "object" &&
-        maybeObj &&
-        typeof maybeObj.message === "string"
-        ? maybeObj.message
-        : `HTTP ${status ?? "error"}`;
-    const ctor = status === 400
-        ? FrontBadRequestError
-        : status === 401
-            ? FrontUnauthorizedError
-            : status === 403
-                ? FrontForbiddenError
-                : status === 404
-                    ? FrontNotFoundError
-                    : status === 409
-                        ? FrontConflictError
-                        : status === 422
-                            ? FrontUnprocessableEntityError
-                            : status === 429
-                                ? FrontRateLimitError
-                                : status && status >= 500
-                                    ? FrontServerError
-                                    : FrontError;
-    console.log({ message, status, code, error, headers });
-    return new ctor(message, status, code, error, headers);
-}
-//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

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

package/dist/core/paginator.d.ts

@@ -1,88 +0,0 @@
-export declare class Page<T> implements AsyncIterable<T> {
-    readonly items: T[];
-    private readonly _getNext;
-    constructor(items: T[], _getNext: (() => Promise<{
-        response: Response;
-        page: Page<T>;
-    } | null>) | null);
-    /**
-     * Whether there is another page available after the current one.
-     */
-    get hasNextPage(): boolean;
-    /**
-     * Fetch the next page of results, if available.
-     *
-     * @returns The next page pair (containing `Response` and `Page<T>`) or `null` if no more pages.
-     */
-    nextPage(): Promise<{
-        response: Response;
-        page: Page<T>;
-    } | null>;
-    /**
-     * Iterate over the items in this page.
-     */
-    [Symbol.asyncIterator](): AsyncGenerator<Awaited<T>, void, unknown>;
-}
-/**
- * Parse the `page_token` query parameter from a `_pagination.next` URL.
- *
- * @param nextUrl - The `_pagination.next` absolute or relative URL
- * @returns The `page_token` value or `null` if it cannot be determined
- */
-export declare function parsePageTokenFromNextUrl(nextUrl?: string | null): string | null;
-/**
- * Safely read the `_pagination.next` URL from a list response body.
- *
- * @param data - The list response body
- * @returns The URL string if present, otherwise `null`
- */
-export declare function getNextUrlFromBody(data: unknown): string | null;
-/**
- * Extract the next `page_token` from a list response body.
- *
- * @param data - The list response body
- * @returns The `page_token` value or `null`
- */
-export declare function getNextPageTokenFromBody(data: unknown): string | null;
-/**
- * Build a `Page<TItem>` from an initial list response and provide a `fetchNext` closure
- * that retrieves subsequent pages, preserving the underlying `Response` object for each.
- *
- * The caller supplies `mapItems` to transform the list response into `TItem[]` and a `fetchNext`
- * function that accepts a `pageToken` and returns `{ response, data }` for the next page.
- *
- * @typeParam TItem - The item type contained in the page
- * @typeParam TListResponse - The concrete list response body type
- * @param args.data - The first page body
- * @param args.fetchNext - A function to fetch the next page given a token
- * @param args.mapItems - A function mapping a response body to an array of items
- * @returns The constructed `Page<TItem>` for the first page
- */
-export declare function buildPageFromListResponse<TItem, TListResponse>(args: {
-    data: TListResponse;
-    fetchNext: (pageToken: string) => Promise<{
-        response: Response;
-        data: TListResponse | undefined;
-    }>;
-    mapItems: (data: TListResponse) => TItem[];
-}): Page<TItem>;
-/** A pair of the raw `Response` and a `Page<T>` of items. */
-export type PagePair<T> = {
-    response: Response;
-    page: Page<T>;
-};
-/**
- * Create an async-iterable result from the first `PagePair<T>` that yields each
- * page pair as it is fetched via `nextPage()`. This allows
- *
- * ```ts
- * for await (const { response, page } of result) { ... }
- * ```
- *
- * while also providing direct access to the first `{ response, page }`.
- *
- * @param first - The first page pair
- * @returns An object containing the first page pair and an async iterator over subsequent pairs
- */
-export declare function makePagedResult<T>(first: PagePair<T>): PagePair<T> & AsyncIterable<PagePair<T>>;
-//# sourceMappingURL=paginator.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"paginator.d.ts","sourceRoot":"","sources":["../../src/core/paginator.ts"],"names":[],"mappings":"AAAA,qBAAa,IAAI,CAAC,CAAC,CAAE,YAAW,aAAa,CAAC,CAAC,CAAC;aAE5B,KAAK,EAAE,CAAC,EAAE;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBADT,KAAK,EAAE,CAAC,EAAE,EACT,QAAQ,EACrB,CAAC,MAAM,OAAO,CAAC;QAAE,QAAQ,EAAE,QAAQ,CAAC;QAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC,GAC7D,IAAI;IAEV;;OAEG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IACD;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC;QAAE,QAAQ,EAAE,QAAQ,CAAC;QAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;IAGvE;;OAEG;IACI,CAAC,MAAM,CAAC,aAAa,CAAC;CAG9B;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GACtB,MAAM,GAAG,IAAI,CASf;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAK/D;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAErE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE;IACpE,IAAI,EAAE,aAAa,CAAA;IACnB,SAAS,EAAE,CACT,SAAS,EAAE,MAAM,KACd,OAAO,CAAC;QAAE,QAAQ,EAAE,QAAQ,CAAC;QAAC,IAAI,EAAE,aAAa,GAAG,SAAS,CAAA;KAAE,CAAC,CAAA;IACrE,QAAQ,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,KAAK,EAAE,CAAA;CAC3C,GAAG,IAAI,CAAC,KAAK,CAAC,CAmBd;AAED,6DAA6D;AAC7D,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAA;CAAE,CAAA;AAE/D;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,GACjB,QAAQ,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAa1C"}

package/dist/core/paginator.js

@@ -1,129 +0,0 @@
-export class Page {
-    items;
-    _getNext;
-    constructor(items, _getNext) {
-        this.items = items;
-        this._getNext = _getNext;
-    }
-    /**
-     * Whether there is another page available after the current one.
-     */
-    get hasNextPage() {
-        return !!this._getNext;
-    }
-    /**
-     * Fetch the next page of results, if available.
-     *
-     * @returns The next page pair (containing `Response` and `Page<T>`) or `null` if no more pages.
-     */
-    async nextPage() {
-        return this._getNext ? this._getNext() : null;
-    }
-    /**
-     * Iterate over the items in this page.
-     */
-    async *[Symbol.asyncIterator]() {
-        for (const i of this.items)
-            yield i;
-    }
-}
-/**
- * Parse the `page_token` query parameter from a `_pagination.next` URL.
- *
- * @param nextUrl - The `_pagination.next` absolute or relative URL
- * @returns The `page_token` value or `null` if it cannot be determined
- */
-export function parsePageTokenFromNextUrl(nextUrl) {
-    if (!nextUrl)
-        return null;
-    try {
-        const u = new URL(nextUrl, "https://api2.frontapp.com");
-        const token = u.searchParams.get("page_token");
-        return token;
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * Safely read the `_pagination.next` URL from a list response body.
- *
- * @param data - The list response body
- * @returns The URL string if present, otherwise `null`
- */
-export function getNextUrlFromBody(data) {
-    if (!data || typeof data !== "object")
-        return null;
-    const body = data;
-    const next = body._pagination?.next;
-    return typeof next === "string" ? next : null;
-}
-/**
- * Extract the next `page_token` from a list response body.
- *
- * @param data - The list response body
- * @returns The `page_token` value or `null`
- */
-export function getNextPageTokenFromBody(data) {
-    return parsePageTokenFromNextUrl(getNextUrlFromBody(data));
-}
-/**
- * Build a `Page<TItem>` from an initial list response and provide a `fetchNext` closure
- * that retrieves subsequent pages, preserving the underlying `Response` object for each.
- *
- * The caller supplies `mapItems` to transform the list response into `TItem[]` and a `fetchNext`
- * function that accepts a `pageToken` and returns `{ response, data }` for the next page.
- *
- * @typeParam TItem - The item type contained in the page
- * @typeParam TListResponse - The concrete list response body type
- * @param args.data - The first page body
- * @param args.fetchNext - A function to fetch the next page given a token
- * @param args.mapItems - A function mapping a response body to an array of items
- * @returns The constructed `Page<TItem>` for the first page
- */
-export function buildPageFromListResponse(args) {
-    const { data, fetchNext, mapItems } = args;
-    const items = mapItems(data);
-    const makeGetNext = (nextToken) => {
-        return async () => {
-            const { response, data: nextData } = await fetchNext(nextToken);
-            if (!nextData)
-                return null;
-            const nextItems = mapItems(nextData);
-            const token2 = getNextPageTokenFromBody(nextData);
-            const nextPage = new Page(nextItems, token2 ? makeGetNext(token2) : null);
-            return { response, page: nextPage };
-        };
-    };
-    const token = getNextPageTokenFromBody(data);
-    return new Page(items, token ? makeGetNext(token) : null);
-}
-/**
- * Create an async-iterable result from the first `PagePair<T>` that yields each
- * page pair as it is fetched via `nextPage()`. This allows
- *
- * ```ts
- * for await (const { response, page } of result) { ... }
- * ```
- *
- * while also providing direct access to the first `{ response, page }`.
- *
- * @param first - The first page pair
- * @returns An object containing the first page pair and an async iterator over subsequent pairs
- */
-export function makePagedResult(first) {
-    return {
-        ...first,
-        async *[Symbol.asyncIterator]() {
-            let current = first;
-            while (current) {
-                yield current;
-                const next = await current.page.nextPage();
-                if (!next)
-                    return;
-                current = next;
-            }
-        },
-    };
-}
-//# sourceMappingURL=paginator.js.map

package/dist/core/paginator.js.map

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

package/dist/core/resource.d.ts

@@ -1,143 +0,0 @@
-import { type PagePair } from "./paginator";
-/**
- * Base class for all resource namespaces.
- *
- * This class encapsulates shared behavior and utilities used by resource
- * wrappers. It is generic over two types:
- *
- * - TItem: The concrete domain instance type exposed by the resource
- *   (e.g., FrontTag, FrontAccount).
- * - TRaw: The raw DTO shape returned by the generated client for the item
- *   (e.g., TagResponse, AccountResponse).
- *
- * Subclasses must implement {@link makeItem} to define how a raw DTO is
- * transformed into a domain instance. By centralizing this transformation,
- * higher-level helpers such as {@link listPaginated} can construct items
- * without duplicated mapping code in each list method.
- */
-export declare abstract class APIResource<TItem = unknown, TRaw = unknown> {
-    /**
-     * Convert a raw DTO returned by the generated client into the domain
-     * instance exposed by the resource.
-     *
-     * Subclasses should implement the minimal logic necessary to wrap the raw
-     * data (typically `return new FrontX(raw)`), keeping domain
-     * classes thin and delegating network operations back to the generated SDK.
-     *
-     * @param raw - The raw DTO for a single resource item
-     * @returns The resource-specific domain instance
-     */
-    protected abstract makeItem(raw: TRaw): TItem;
-    /**
-     * Helper for list endpoints that use Front's standard pagination shape.
-     *
-     * This function wires the first page and an async iterator over subsequent
-     * pages, while preserving the underlying `Response` object for each request.
-     * It expects the list response body to contain an `_results` array and a
-     * `_pagination.next` link that encodes the next `page_token`.
-     *
-     * Usage pattern in a resource wrapper:
-     *
-     * ```ts
-     * async list(query?: ListXData["query"]) {
-     *   return this.listPaginated<ListXResponse, { query?: ListXData["query"]}>({
-     *     initialOptions: { query },
-     *     listCall: (options) => listX({ ...options }),
-     *   })
-     * }
-     * ```
-     *
-     * Notes
-     * - The method automatically appends `page_token` to the provided
-     *   `initialOptions.query` on subsequent page fetches.
-     * - Item mapping is handled via {@link makeItem}, avoiding per-call
-     *   mapping boilerplate.
-     *
-     * @typeParam TListResponse - The concrete list response type with `_results`
-     * @typeParam TOptions - The options accepted by the generated list function,
-     *   which must include an optional `query.page_token` string
-     * @param opts.initialOptions - Initial options passed to the generated list function
-     * @param opts.listCall - The generated list function to execute
-     * @returns The first page pair and an async iterable over subsequent page pairs
-     */
-    protected listPaginated<TListResponse extends {
-        _results?: Array<TRaw>;
-    }, TOptions extends {
-        query?: {
-            page_token?: string;
-        };
-    }>(opts: {
-        initialOptions: TOptions;
-        listCall: (options: TOptions) => Promise<{
-            response: Response;
-            data?: TListResponse;
-        }>;
-    }): Promise<PagePair<TItem> & AsyncIterable<PagePair<TItem>>>;
-    /**
-     * Helper for list endpoints that return a single, non-paginated array of results.
-     *
-     * Maps the `_results` array into domain items using {@link makeItem} and returns
-     * a simple `{ response, data }` pair.
-     */
-    protected listWithoutPagination<TListResponse extends {
-        _results?: Array<TRaw>;
-    }>(opts: {
-        listCall: () => Promise<{
-            response: Response;
-            data?: TListResponse;
-        }>;
-    }): Promise<{
-        response: Response;
-        data: TItem[];
-    }>;
-    /**
-     * Helper for singular GET endpoints that return one entity.
-     *
-     * Provide a GET call closure that performs the request using the
-     * generated SDK. The response body type must be assignable to `TRaw`.
-     */
-    protected getOne<TGet extends TRaw>(opts: {
-        getCall: () => Promise<{
-            response: Response;
-            data?: TGet;
-        }>;
-    }): Promise<{
-        item: TItem;
-        response: Response;
-    }>;
-    /**
-     * Helper for singular CREATE endpoints that return one entity.
-     *
-     * Provide a CREATE call closure that performs the request using the
-     * generated SDK. The response body type must be assignable to `TRaw`.
-     */
-    protected createOne<TCreate extends TRaw>(opts: {
-        createCall: () => Promise<{
-            response: Response;
-            data?: TCreate;
-        }>;
-    }): Promise<{
-        item: TItem;
-        response: Response;
-    }>;
-}
-/**
- * Base class for domain instances (e.g., `FrontTag`, `FrontAccount`).
- *
- * Provides a shared shape for thin wrappers around raw API DTOs, exposing a
- * `toJSON()` method that returns the underlying raw data for serialization or
- * persistence. Subclasses can add getters for commonly accessed fields and
- * instance methods that delegate mutations back to the generated SDK.
- */
-export declare abstract class ResourceInstance<T> {
-    protected _data: T;
-    protected constructor(_data: T);
-    /**
-     * Return the underlying raw DTO for this domain instance.
-     *
-     * Prefer using the typed getters on subclasses for read access and methods
-     * that call the generated SDK for mutations.
-     */
-    toJSON(): T;
-}
-//# sourceMappingURL=resource.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../../src/core/resource.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,QAAQ,EACd,MAAM,aAAa,CAAA;AAEpB;;;;;;;;;;;;;;;GAeG;AACH,8BAAsB,WAAW,CAAC,KAAK,GAAG,OAAO,EAAE,IAAI,GAAG,OAAO;IAC/D;;;;;;;;;;OAUG;IACH,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,GAAG,KAAK;IAE7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;cACa,aAAa,CAC3B,aAAa,SAAS;QAAE,QAAQ,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;KAAE,EAChD,QAAQ,SAAS;QAAE,KAAK,CAAC,EAAE;YAAE,UAAU,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,EACpD,IAAI,EAAE;QACN,cAAc,EAAE,QAAQ,CAAA;QACxB,QAAQ,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,OAAO,CAAC;YACvC,QAAQ,EAAE,QAAQ,CAAA;YAClB,IAAI,CAAC,EAAE,aAAa,CAAA;SACrB,CAAC,CAAA;KACH,GAAG,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IA2B7D;;;;;OAKG;cACa,qBAAqB,CACnC,aAAa,SAAS;QAAE,QAAQ,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;KAAE,EAChD,IAAI,EAAE;QACN,QAAQ,EAAE,MAAM,OAAO,CAAC;YAAE,QAAQ,EAAE,QAAQ,CAAC;YAAC,IAAI,CAAC,EAAE,aAAa,CAAA;SAAE,CAAC,CAAA;KACtE,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,QAAQ,CAAC;QAAC,IAAI,EAAE,KAAK,EAAE,CAAA;KAAE,CAAC;IAQlD;;;;;OAKG;cACa,MAAM,CAAC,IAAI,SAAS,IAAI,EAAE,IAAI,EAAE;QAC9C,OAAO,EAAE,MAAM,OAAO,CAAC;YAAE,QAAQ,EAAE,QAAQ,CAAC;YAAC,IAAI,CAAC,EAAE,IAAI,CAAA;SAAE,CAAC,CAAA;KAC5D,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,KAAK,CAAC;QAAC,QAAQ,EAAE,QAAQ,CAAA;KAAE,CAAC;IAOhD;;;;;OAKG;cACa,SAAS,CAAC,OAAO,SAAS,IAAI,EAAE,IAAI,EAAE;QACpD,UAAU,EAAE,MAAM,OAAO,CAAC;YAAE,QAAQ,EAAE,QAAQ,CAAC;YAAC,IAAI,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC,CAAA;KAClE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,KAAK,CAAC;QAAC,QAAQ,EAAE,QAAQ,CAAA;KAAE,CAAC;CAKjD;AAED;;;;;;;GAOG;AACH,8BAAsB,gBAAgB,CAAC,CAAC;IAChB,SAAS,CAAC,KAAK,EAAE,CAAC;IAAxC,SAAS,aAAuB,KAAK,EAAE,CAAC;IACxC;;;;;OAKG;IACH,MAAM,IAAI,CAAC;CAGZ"}

package/dist/core/resource.js

@@ -1,132 +0,0 @@
-import { buildPageFromListResponse, makePagedResult, } from "./paginator";
-/**
- * Base class for all resource namespaces.
- *
- * This class encapsulates shared behavior and utilities used by resource
- * wrappers. It is generic over two types:
- *
- * - TItem: The concrete domain instance type exposed by the resource
- *   (e.g., FrontTag, FrontAccount).
- * - TRaw: The raw DTO shape returned by the generated client for the item
- *   (e.g., TagResponse, AccountResponse).
- *
- * Subclasses must implement {@link makeItem} to define how a raw DTO is
- * transformed into a domain instance. By centralizing this transformation,
- * higher-level helpers such as {@link listPaginated} can construct items
- * without duplicated mapping code in each list method.
- */
-export class APIResource {
-    /**
-     * Helper for list endpoints that use Front's standard pagination shape.
-     *
-     * This function wires the first page and an async iterator over subsequent
-     * pages, while preserving the underlying `Response` object for each request.
-     * It expects the list response body to contain an `_results` array and a
-     * `_pagination.next` link that encodes the next `page_token`.
-     *
-     * Usage pattern in a resource wrapper:
-     *
-     * ```ts
-     * async list(query?: ListXData["query"]) {
-     *   return this.listPaginated<ListXResponse, { query?: ListXData["query"]}>({
-     *     initialOptions: { query },
-     *     listCall: (options) => listX({ ...options }),
-     *   })
-     * }
-     * ```
-     *
-     * Notes
-     * - The method automatically appends `page_token` to the provided
-     *   `initialOptions.query` on subsequent page fetches.
-     * - Item mapping is handled via {@link makeItem}, avoiding per-call
-     *   mapping boilerplate.
-     *
-     * @typeParam TListResponse - The concrete list response type with `_results`
-     * @typeParam TOptions - The options accepted by the generated list function,
-     *   which must include an optional `query.page_token` string
-     * @param opts.initialOptions - Initial options passed to the generated list function
-     * @param opts.listCall - The generated list function to execute
-     * @returns The first page pair and an async iterable over subsequent page pairs
-     */
-    async listPaginated(opts) {
-        const { initialOptions, listCall } = opts;
-        const result = await listCall(initialOptions);
-        if (!result.data)
-            throw new Error("No results");
-        const page = buildPageFromListResponse({
-            data: result.data,
-            mapItems: (d) => (d._results ?? []).map((raw) => this.makeItem(raw)),
-            fetchNext: async (pageToken) => {
-                const nextOptions = {
-                    ...initialOptions,
-                    query: { ...(initialOptions.query ?? {}), page_token: pageToken },
-                };
-                const res2 = await listCall(nextOptions);
-                return {
-                    response: res2.response,
-                    data: res2.data ?? undefined,
-                };
-            },
-        });
-        return makePagedResult({ response: result.response, page });
-    }
-    /**
-     * Helper for list endpoints that return a single, non-paginated array of results.
-     *
-     * Maps the `_results` array into domain items using {@link makeItem} and returns
-     * a simple `{ response, data }` pair.
-     */
-    async listWithoutPagination(opts) {
-        const result = await opts.listCall();
-        const items = (result.data?._results ?? []).map((raw) => this.makeItem(raw));
-        return { response: result.response, data: items };
-    }
-    /**
-     * Helper for singular GET endpoints that return one entity.
-     *
-     * Provide a GET call closure that performs the request using the
-     * generated SDK. The response body type must be assignable to `TRaw`.
-     */
-    async getOne(opts) {
-        const result = await opts.getCall();
-        if (!result.data)
-            throw new Error("Missing data");
-        return { item: this.makeItem(result.data), response: result.response };
-    }
-    /**
-     * Helper for singular CREATE endpoints that return one entity.
-     *
-     * Provide a CREATE call closure that performs the request using the
-     * generated SDK. The response body type must be assignable to `TRaw`.
-     */
-    async createOne(opts) {
-        const result = await opts.createCall();
-        if (!result.data)
-            throw new Error("Missing data");
-        return { item: this.makeItem(result.data), response: result.response };
-    }
-}
-/**
- * Base class for domain instances (e.g., `FrontTag`, `FrontAccount`).
- *
- * Provides a shared shape for thin wrappers around raw API DTOs, exposing a
- * `toJSON()` method that returns the underlying raw data for serialization or
- * persistence. Subclasses can add getters for commonly accessed fields and
- * instance methods that delegate mutations back to the generated SDK.
- */
-export class ResourceInstance {
-    _data;
-    constructor(_data) {
-        this._data = _data;
-    }
-    /**
-     * Return the underlying raw DTO for this domain instance.
-     *
-     * Prefer using the typed getters on subclasses for read access and methods
-     * that call the generated SDK for mutations.
-     */
-    toJSON() {
-        return this._data;
-    }
-}
-//# sourceMappingURL=resource.js.map

package/dist/core/resource.js.map

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