@arionhardison/wizard-api-client 1.2.1

package/dist/api/wizard-setup-api-client.js

@@ -0,0 +1,171 @@
+"use strict";
+/**
+ * WizardSetupApiClient — covers `/api/wizard/*` setup endpoints (27 in
+ * total). All `auth: api`.
+ *
+ * NOTE: The Five-Step Wizard methods (`/api/wizard/define-problem`,
+ * `/api/wizard/codify-solution`, `/api/wizard/setup-program`,
+ * `/api/wizard/execute-program`, `/api/wizard/verify-outcome`) are owned
+ * by `WizardApiClient` (`src/api/wizard-api-client.ts`) and are NOT
+ * included here.
+ *
+ * This client covers the *program-creation onboarding* surface:
+ * assessments, profile completion, account confirmation, member
+ * invitations, Stripe connection, publishing, and state management.
+ *
+ * Source of truth: `sdk/spec/endpoints.json`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WizardSetupApiClient = void 0;
+const api_client_1 = require("../api-client");
+class WizardSetupApiClient extends api_client_1.BaseApiClient {
+    // ---------------------------------------------------------------------------
+    // Assessment lookups
+    // ---------------------------------------------------------------------------
+    /** GET /api/wizard/assessment/answers/{protocol} */
+    async getAssessmentAnswers(protocol) {
+        return this.get(`/api/wizard/assessment/answers/${encodeURIComponent(String(protocol))}`);
+    }
+    /** GET /api/wizard/assessment/questions/{protocol} */
+    async getAssessmentQuestions(protocol) {
+        return this.get(`/api/wizard/assessment/questions/${encodeURIComponent(String(protocol))}`);
+    }
+    // ---------------------------------------------------------------------------
+    // Profile + account
+    // ---------------------------------------------------------------------------
+    /** POST /api/wizard/complete-profile/{protocol} */
+    async completeProfile(protocol, body) {
+        return this.post(`/api/wizard/complete-profile/${encodeURIComponent(String(protocol))}`, body);
+    }
+    /** POST /api/wizard/confirm-account/{protocol} */
+    async confirmAccount(protocol, body) {
+        return this.post(`/api/wizard/confirm-account/${encodeURIComponent(String(protocol))}`, body);
+    }
+    /** POST /api/wizard/confirm-code/{protocol} */
+    async confirmCode(protocol, body) {
+        return this.post(`/api/wizard/confirm-code/${encodeURIComponent(String(protocol))}`, body);
+    }
+    /** POST /api/wizard/confirm-preview/{protocol} — accepts a program image (File OK). */
+    async confirmPreview(protocol, body) {
+        return this.post(`/api/wizard/confirm-preview/${encodeURIComponent(String(protocol))}`, body);
+    }
+    /** POST /api/wizard/creator-request/{protocol} — KYC photos (File OK). */
+    async submitCreatorRequest(protocol, body) {
+        return this.post(`/api/wizard/creator-request/${encodeURIComponent(String(protocol))}`, body);
+    }
+    // ---------------------------------------------------------------------------
+    // Stripe + finances
+    // ---------------------------------------------------------------------------
+    /** GET /api/wizard/connect-stripe/{protocol} */
+    async connectStripe(protocol) {
+        return this.get(`/api/wizard/connect-stripe/${encodeURIComponent(String(protocol))}`);
+    }
+    /** GET /api/wizard/verify-stripe/{protocol} */
+    async verifyStripe(protocol) {
+        return this.get(`/api/wizard/verify-stripe/${encodeURIComponent(String(protocol))}`);
+    }
+    /** GET /api/wizard/finances/{protocol} */
+    async getFinances(protocol) {
+        return this.get(`/api/wizard/finances/${encodeURIComponent(String(protocol))}`);
+    }
+    /** POST /api/wizard/set-finances/{protocol} */
+    async setFinances(protocol, body = {}) {
+        return this.post(`/api/wizard/set-finances/${encodeURIComponent(String(protocol))}`, body);
+    }
+    // ---------------------------------------------------------------------------
+    // State + finalization
+    // ---------------------------------------------------------------------------
+    /** GET /api/wizard/finalization-state/{protocol} */
+    async getFinalizationState(protocol) {
+        return this.get(`/api/wizard/finalization-state/${encodeURIComponent(String(protocol))}`);
+    }
+    /** GET /api/wizard/get-state/{protocol} */
+    async getWizardState(protocol) {
+        return this.get(`/api/wizard/get-state/${encodeURIComponent(String(protocol))}`);
+    }
+    /** GET /api/wizard/program-data/{protocol} */
+    async getProgramData(protocol) {
+        return this.get(`/api/wizard/program-data/${encodeURIComponent(String(protocol))}`);
+    }
+    /** GET /api/wizard/public-program-created/{protocol} */
+    async getPublicProgramCreated(protocol) {
+        return this.get(`/api/wizard/public-program-created/${encodeURIComponent(String(protocol))}`);
+    }
+    /** GET /api/wizard/retry-creation/{protocol} */
+    async retryCreation(protocol) {
+        return this.get(`/api/wizard/retry-creation/${encodeURIComponent(String(protocol))}`);
+    }
+    /** GET /api/wizard/start-program/{protocol} */
+    async startProgram(protocol) {
+        return this.get(`/api/wizard/start-program/${encodeURIComponent(String(protocol))}`);
+    }
+    /** GET /api/wizard/step-back/{protocol} */
+    async stepBack(protocol) {
+        return this.get(`/api/wizard/step-back/${encodeURIComponent(String(protocol))}`);
+    }
+    // ---------------------------------------------------------------------------
+    // Members / team
+    // ---------------------------------------------------------------------------
+    /** POST /api/wizard/find-members */
+    async findMembers(body) {
+        return this.post('/api/wizard/find-members', body);
+    }
+    /** GET /api/wizard/get-required-roles/{protocol} */
+    async getRequiredRoles(protocol) {
+        return this.get(`/api/wizard/get-required-roles/${encodeURIComponent(String(protocol))}`);
+    }
+    /** POST /api/wizard/invite-members/{protocol} */
+    async inviteMembers(protocol, body) {
+        return this.post(`/api/wizard/invite-members/${encodeURIComponent(String(protocol))}`, body);
+    }
+    /** POST /api/wizard/invite-users/{protocol} */
+    async inviteUsers(protocol, body) {
+        return this.post(`/api/wizard/invite-users/${encodeURIComponent(String(protocol))}`, body);
+    }
+    /** GET /api/wizard/team/roles-to-invite/{protocol} */
+    async getRolesToInvite(protocol) {
+        return this.get(`/api/wizard/team/roles-to-invite/${encodeURIComponent(String(protocol))}`);
+    }
+    // ---------------------------------------------------------------------------
+    // Misc setup
+    // ---------------------------------------------------------------------------
+    /** POST /api/wizard/publish-program/{protocol} */
+    async publishProgram(protocol, body) {
+        return this.post(`/api/wizard/publish-program/${encodeURIComponent(String(protocol))}`, body);
+    }
+    /** POST /api/wizard/set-agent/{protocol} */
+    async setAgent(protocol, body) {
+        return this.post(`/api/wizard/set-agent/${encodeURIComponent(String(protocol))}`, body);
+    }
+    /** POST /api/wizard/set-distribution-type/{protocol} */
+    async setDistributionType(protocol, body) {
+        return this.post(`/api/wizard/set-distribution-type/${encodeURIComponent(String(protocol))}`, body);
+    }
+    /** POST /api/wizard/validate-email */
+    async validateEmail(body) {
+        return this.post('/api/wizard/validate-email', body);
+    }
+}
+exports.WizardSetupApiClient = WizardSetupApiClient;
+// =============================================================================
+// Re-export hint for `src/index.ts`
+// -----------------------------------------------------------------------------
+//   export { WizardSetupApiClient } from './api/wizard-setup-api-client';
+//   export type {
+//     WizardCompleteProfileRequest,
+//     WizardConfirmAccountRequest,
+//     WizardConfirmCodeRequest,
+//     WizardConfirmPreviewRequest,
+//     WizardCreatorRequestPayload,
+//     WizardFindMembersRequest,
+//     WizardInviteMembersRequest,
+//     WizardInviteUsersRequest,
+//     WizardPublishProgramRequest,
+//     WizardSetAgentRequest,
+//     WizardSetDistributionTypeRequest,
+//     WizardSetFinancesRequest,
+//     WizardSetupResponse,
+//     WizardValidateEmailRequest,
+//   } from './api/wizard-setup-api-client';
+// =============================================================================
+//# sourceMappingURL=wizard-setup-api-client.js.map

package/dist/api/wizard-setup-api-client.js.map

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

package/dist/api-client.d.ts

@@ -0,0 +1,232 @@
+/**
+ * SDK core HTTP client (fetch-based).
+ *
+ * This module is the foundation that the four frontends — CI-WWW, sys, gov,
+ * app — depend on. Behavior is locked by the cross-cutting contract suite at
+ * `src/__tests__/contract/base-client.contract.test.ts` — read those tests
+ * first if you're tempted to "just tweak" the request flow.
+ *
+ * Key invariants (see contract tests for the full spec):
+ *
+ *   - Auth header injection is opt-in via `getToken`. No browser globals are
+ *     touched at construction time so the SDK is SSR-safe.
+ *   - `X-Domain` header injection is opt-in via `getDomain` and never
+ *     defaults to `localhost`.
+ *   - PUT/PATCH are sent as POST + `?_method=PUT|PATCH` (Laravel convention).
+ *     DELETE stays a real DELETE.
+ *   - Payloads carrying a `File`/`Blob` switch to `multipart/form-data` and
+ *     serialize nested arrays as `field[i][nested]=value`.
+ *   - 401 / 422 dispatch to `onUnauthorized` / `onValidationError` callbacks
+ *     and throw a normalized `ApiError`. The SDK NEVER navigates the browser.
+ *   - Per-call options: `auth: false` (skip Authorization), `safe: true`
+ *     (return null on network failure), `validateStatus` (custom non-throw
+ *     ranges), `signal` (AbortController support).
+ *
+ * The legacy `BaseApiClient` API surface (`get` / `post` / `put` / `delete`
+ * + the `protected request()` escape hatch) is preserved so existing
+ * subclasses keep working. New behavior is additive.
+ */
+/** Standard response envelope every Laravel endpoint returns. */
+export interface ApiResponse<T = any> {
+    success: boolean;
+    message: string;
+    data: T;
+    meta?: ApiMetaData;
+}
+/** Metadata included in API responses */
+export interface ApiMetaData {
+    timestamp: string;
+    apiVersion: string;
+}
+/**
+ * Configuration for `BaseApiClient`. Old fields (`baseURL`, `timeout`,
+ * `withCredentials`, `headers`) are preserved. New optional fields make the
+ * client SSR-safe and let frontends inject their auth + tenancy strategies.
+ */
+export interface ApiClientConfig {
+    baseURL: string;
+    timeout?: number;
+    withCredentials?: boolean;
+    headers?: Record<string, string>;
+    /**
+     * Returns the current auth token, or null/undefined to omit the
+     * Authorization header. SSR-safe — the SDK never touches localStorage
+     * directly when this is provided.
+     */
+    getToken?: () => string | null | undefined;
+    /**
+     * Returns the current `X-Domain` value, or null/undefined to omit the
+     * header. The SDK does NOT default this to `localhost` (gov/sys/app each
+     * have their own resolution rules).
+     */
+    getDomain?: () => string | null | undefined;
+    /** Fired exactly once per 401 response. Replaces the old window-event flow. */
+    onUnauthorized?: () => void;
+    /** Fired exactly once per 422 response with the parsed validation map. */
+    onValidationError?: (errors: Record<string, string[]>) => void;
+    /**
+     * Optional fetch implementation injection point. Used in tests and for
+     * SSR runtimes that polyfill fetch differently (e.g. node-fetch).
+     */
+    fetch?: typeof fetch;
+    enableRetry?: boolean;
+    maxRetries?: number;
+}
+/** Per-request options. All optional; sensible defaults match legacy behavior. */
+export interface ApiRequestOptions {
+    /** When false, Authorization is omitted for this call. Default: true. */
+    auth?: boolean;
+    /** When true, network failures resolve to null instead of throwing. */
+    safe?: boolean;
+    /** Custom non-throw status range. Defaults to `s => s >= 200 && s < 300`. */
+    validateStatus?: (status: number) => boolean;
+    /** AbortSignal for cancellation. */
+    signal?: AbortSignal;
+}
+/**
+ * Base API Client class that handles common functionality using fetch.
+ *
+ * Constructor & public methods are stable — the contract suite + every
+ * downstream module rely on them. Behavior is opted into via `ApiClientConfig`
+ * fields; if none are set, the client falls back to legacy semantics
+ * (read auth token from localStorage iff `window` exists; dispatch
+ * `auth:unauthorized` on 401).
+ */
+export declare class BaseApiClient {
+    protected readonly baseURL: string;
+    protected readonly timeout: number;
+    protected readonly withCredentials: boolean;
+    protected readonly defaultHeaders: Record<string, string>;
+    protected readonly config: ApiClientConfig;
+    constructor(config: ApiClientConfig);
+    /** Resolve the auth token using injected `getToken`, falling back to localStorage iff window exists. */
+    protected resolveToken(): string | null;
+    /** Resolve the `X-Domain` value. Null/undefined = omit. Never defaults. */
+    protected resolveDomain(): string | null;
+    /** True if the payload contains any `File` / `Blob` (recursively). */
+    protected hasBinary(value: unknown): boolean;
+    /**
+     * Recursively serialize an object into FormData using Laravel's
+     * `field[0][nested]=value` bracket notation. Booleans become `'1'`/`'0'`.
+     */
+    protected toFormData(payload: Record<string, unknown>): FormData;
+    /**
+     * Core dispatch. Handles header injection, method override, body
+     * serialization, status validation, and ApiError normalization.
+     *
+     * `RequestInit` is honored as-is so subclasses can pass cookies / mode /
+     * etc. through if they need to.
+     */
+    protected request<T>(endpoint: string, init?: RequestInit, opts?: ApiRequestOptions): Promise<ApiResponse<T>>;
+    /** Pull `{ field: string[] }` out of either Laravel-default or legacy nested envelope. */
+    protected extractValidationErrors(parsed: any): Record<string, string[]> | undefined;
+    /**
+     * Build the request body + headers based on the supplied data. Used by
+     * post/put/patch verb wrappers. Returns `{ body, isMultipart }`.
+     */
+    protected serializeBody(data: unknown): {
+        body: BodyInit | undefined;
+        isMultipart: boolean;
+    };
+    protected get<T>(endpoint: string, params?: Record<string, any>, opts?: ApiRequestOptions): Promise<ApiResponse<T>>;
+    protected post<T>(endpoint: string, data?: any, opts?: ApiRequestOptions): Promise<ApiResponse<T>>;
+    protected put<T>(endpoint: string, data?: any, opts?: ApiRequestOptions): Promise<ApiResponse<T>>;
+    protected patch<T>(endpoint: string, data?: any, opts?: ApiRequestOptions): Promise<ApiResponse<T>>;
+    protected delete<T>(endpoint: string, opts?: ApiRequestOptions): Promise<ApiResponse<T>>;
+}
+/** Item DTO interfaces based on PHP DTOs */
+export interface ItemData {
+    id: number;
+    name: string;
+    description: string;
+    price: number;
+    status: ItemStatus;
+    imageUrl?: string | null;
+    createdAt?: string | null;
+    updatedAt?: string | null;
+}
+/** ItemCollection DTO */
+export interface ItemCollectionData {
+    items: ItemData[];
+}
+/** Item Status Enum */
+export declare enum ItemStatus {
+    ACTIVE = "active",
+    INACTIVE = "inactive",
+    PENDING = "pending",
+    DELETED = "deleted"
+}
+/** FoodData DTO */
+export interface FoodData {
+    id: number;
+    name: string;
+    description: string | null;
+    protein: number | null;
+    carbs: number | null;
+    fat: number | null;
+    calories: number | null;
+    createdAt: string | null;
+    updatedAt: string | null;
+}
+/** FoodCollection DTO */
+export interface FoodCollectionData {
+    items: FoodData[];
+}
+/** User DTO */
+export interface UserData {
+    id: number;
+    name: string;
+    email: string;
+    roles: string[];
+    createdAt: string;
+    updatedAt: string;
+}
+/** Authentication DTO */
+export interface AuthData {
+    token: string;
+    user: UserData;
+    expiresAt: string;
+}
+/** Login DTO */
+export interface LoginData {
+    email: string;
+    password: string;
+    rememberMe?: boolean;
+}
+/** Pagination DTO */
+export interface PaginationData {
+    currentPage: number;
+    lastPage: number;
+    perPage: number;
+    total: number;
+}
+/** Paginated Response DTO */
+export interface PaginatedResponse<T> {
+    items: T[];
+    pagination: PaginationData;
+}
+/** Specific client implementation for the Items module */
+export declare class ItemsApiClient extends BaseApiClient {
+    getItems(params?: {
+        status?: ItemStatus;
+        page?: number;
+        perPage?: number;
+    }): Promise<ApiResponse<ItemCollectionData>>;
+    getItem(id: number): Promise<ApiResponse<ItemData>>;
+    createItem(data: Omit<ItemData, 'id' | 'createdAt' | 'updatedAt'>): Promise<ApiResponse<ItemData>>;
+    updateItem(id: number, data: Partial<Omit<ItemData, 'id' | 'createdAt' | 'updatedAt'>>): Promise<ApiResponse<ItemData>>;
+    deleteItem(id: number): Promise<ApiResponse<null>>;
+}
+/** Authentication API Client */
+export declare class AuthApiClient extends BaseApiClient {
+    login(data: LoginData): Promise<ApiResponse<AuthData>>;
+    logout(): Promise<ApiResponse<null>>;
+    getCurrentUser(): Promise<ApiResponse<UserData>>;
+    isAuthenticated(): boolean;
+}
+/** Factory function to create API clients */
+export declare function createApiClient(config: ApiClientConfig): {
+    items: ItemsApiClient;
+    auth: AuthApiClient;
+};
+//# sourceMappingURL=api-client.d.ts.map

package/dist/api-client.d.ts.map

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