@mapples/request 0.1.0

package/dist/RequestActionHandler.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Bridges the `@mapples/action` store to request execution: subscribes to
+ * emitted actions, resolves `mapples:request` actions into commands, executes
+ * them (sample or real fetch), stores responses via the surrounding
+ * `RequestProvider`, and re-emits `onSuccess`/`onError` follow-up actions
+ * (e.g. `mapples:navigate`) onto the same bus. Renders nothing.
+ *
+ * Must be rendered inside both `RequestProvider` and `ActionProvider`.
+ */
+declare const RequestActionHandler: () => null;
+export default RequestActionHandler;
+//# sourceMappingURL=RequestActionHandler.d.ts.map

package/dist/RequestActionHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequestActionHandler.d.ts","sourceRoot":"","sources":["../src/RequestActionHandler.tsx"],"names":[],"mappings":"AAWA;;;;;;;;GAQG;AACH,QAAA,MAAM,oBAAoB,YAuFzB,CAAC;AAEF,eAAe,oBAAoB,CAAC"}

package/dist/RequestActionHandler.js

@@ -0,0 +1,97 @@
+import { useEffect } from 'react';
+import { useActionStore } from '@mapples/action';
+import { useDataState } from '@mapples/state';
+import { toRequestCommand } from './actionCommands';
+import { useRequestRuntime } from './RequestProvider';
+/** Artificial latency for sample mode so loading states are visible. */
+const SAMPLE_DELAY_MS = 500;
+/**
+ * Bridges the `@mapples/action` store to request execution: subscribes to
+ * emitted actions, resolves `mapples:request` actions into commands, executes
+ * them (sample or real fetch), stores responses via the surrounding
+ * `RequestProvider`, and re-emits `onSuccess`/`onError` follow-up actions
+ * (e.g. `mapples:navigate`) onto the same bus. Renders nothing.
+ *
+ * Must be rendered inside both `RequestProvider` and `ActionProvider`.
+ */
+const RequestActionHandler = () => {
+    const actionStore = useActionStore();
+    const runtime = useRequestRuntime();
+    const { getValue } = useDataState();
+    useEffect(() => {
+        if (!runtime?.document)
+            return;
+        const { document, mode, secrets, setResponse } = runtime;
+        const emitFollowUp = (followUp) => {
+            if (!followUp?.type)
+                return;
+            actionStore.next({
+                time: Date.now(),
+                type: followUp.type,
+                payload: { data: followUp.data },
+            });
+        };
+        const execute = async (command) => {
+            setResponse(command.stateKey, { loading: true });
+            if (mode === 'sample') {
+                setTimeout(() => {
+                    setResponse(command.stateKey, {
+                        loading: false,
+                        data: command.responseSample ?? null,
+                        status: 200,
+                    });
+                    emitFollowUp(command.onSuccess);
+                }, SAMPLE_DELAY_MS);
+                return;
+            }
+            try {
+                const response = await fetch(command.url, {
+                    method: command.method,
+                    headers: command.headers,
+                    body: command.body !== undefined
+                        ? JSON.stringify(command.body)
+                        : undefined,
+                });
+                // Only bodies that declare JSON are parsed. A body that claims JSON and
+                // fails to parse is a broken server contract, so the parse error is left
+                // to reach the handler below instead of quietly becoming `null` data.
+                const contentType = response.headers.get('content-type') ?? '';
+                const data = contentType.includes('json')
+                    ? await response.json()
+                    : null;
+                setResponse(command.stateKey, {
+                    loading: false,
+                    data,
+                    status: response.status,
+                    error: response.ok ? undefined : `HTTP ${response.status}`,
+                });
+                emitFollowUp(response.ok ? command.onSuccess : command.onError);
+            }
+            catch (error) {
+                // A network/CORS/parse failure is a failed request. It is reported as
+                // one: no sample data is substituted for the real response, and only
+                // the configured error follow-up runs — never `onSuccess`, which would
+                // advance the flow as if the request had worked.
+                setResponse(command.stateKey, {
+                    loading: false,
+                    data: null,
+                    error: error instanceof Error ? error.message : 'Request failed',
+                });
+                emitFollowUp(command.onError);
+            }
+        };
+        const subscription = actionStore.subscribe((action) => {
+            const command = toRequestCommand(action, document, {
+                getStateValue: (path) => getValue({ key: path, active: true }),
+                secrets,
+            });
+            if (!command)
+                return;
+            void execute(command);
+        });
+        return () => subscription.unsubscribe();
+    }, [actionStore, getValue, runtime]);
+    return null;
+};
+export default RequestActionHandler;
+//# sourceMappingURL=RequestActionHandler.js.map

package/dist/RequestActionHandler.js.map

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

package/dist/RequestProvider.d.ts

@@ -0,0 +1,35 @@
+import { FC, PropsWithChildren } from 'react';
+import { ApiDocument } from '@mapples/types';
+/** Per-request response state, exposed to bindings under the state key. */
+export interface ResponseState {
+    loading: boolean;
+    data?: unknown;
+    error?: string;
+    status?: number;
+}
+export type RequestExecutionMode = 'sample' | 'fetch';
+export interface RequestRuntimeContextType {
+    document: ApiDocument | null;
+    mode: RequestExecutionMode;
+    secrets?: Record<string, string>;
+    setResponse: (stateKey: string, state: ResponseState) => void;
+}
+export declare const useRequestRuntime: () => RequestRuntimeContextType | null;
+export interface RequestProviderProps {
+    document?: ApiDocument | null;
+    /** Base state the responses are merged over. */
+    state?: object;
+    /** `sample` resolves `responseSample`s; `fetch` performs real requests. */
+    mode?: RequestExecutionMode;
+    secrets?: Record<string, string>;
+}
+/**
+ * Holds API response state and republishes it through `@mapples/state`, so
+ * bindings like `api.login.data.user.name` and conditions like
+ * `api.login.loading::eq::true` resolve with zero changes to the state
+ * package. Pair with `RequestActionHandler` (rendered as a child) to execute
+ * `mapples:request` actions.
+ */
+declare const RequestProvider: FC<PropsWithChildren<RequestProviderProps>>;
+export default RequestProvider;
+//# sourceMappingURL=RequestProvider.d.ts.map

package/dist/RequestProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequestProvider.d.ts","sourceRoot":"","sources":["../src/RequestProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,EAAE,EACF,iBAAiB,EAKlB,MAAM,OAAO,CAAC;AAGf,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C,2EAA2E;AAC3E,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEtD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;IAC7B,IAAI,EAAE,oBAAoB,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;CAC/D;AAMD,eAAO,MAAM,iBAAiB,wCAA0C,CAAC;AAEzE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAC9B,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,IAAI,CAAC,EAAE,oBAAoB,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;;;;GAMG;AACH,QAAA,MAAM,eAAe,EAAE,EAAE,CAAC,iBAAiB,CAAC,oBAAoB,CAAC,CAoChE,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/dist/RequestProvider.js

@@ -0,0 +1,33 @@
+import { createContext, useCallback, useContext, useMemo, useState, } from 'react';
+import StateProvider from '@mapples/state';
+import { cloneDeep, set } from 'lodash';
+const RequestRuntimeContext = createContext(null);
+export const useRequestRuntime = () => useContext(RequestRuntimeContext);
+/**
+ * Holds API response state and republishes it through `@mapples/state`, so
+ * bindings like `api.login.data.user.name` and conditions like
+ * `api.login.loading::eq::true` resolve with zero changes to the state
+ * package. Pair with `RequestActionHandler` (rendered as a child) to execute
+ * `mapples:request` actions.
+ */
+const RequestProvider = ({ children, document = null, state, mode = 'sample', secrets, }) => {
+    const [responses, setResponses] = useState({});
+    const setResponse = useCallback((stateKey, response) => {
+        setResponses((prev) => ({ ...prev, [stateKey]: response }));
+    }, []);
+    // State keys are dot paths (`api.login`) — expand them into the nested
+    // object shape @mapples/state resolves against.
+    const mergedState = useMemo(() => {
+        const result = cloneDeep(state ?? {});
+        for (const [stateKey, response] of Object.entries(responses)) {
+            set(result, stateKey, response);
+        }
+        return result;
+    }, [responses, state]);
+    const contextValue = useMemo(() => ({ document, mode, secrets, setResponse }), [document, mode, secrets, setResponse]);
+    return (<RequestRuntimeContext value={contextValue}>
+      <StateProvider state={mergedState}>{children}</StateProvider>
+    </RequestRuntimeContext>);
+};
+export default RequestProvider;
+//# sourceMappingURL=RequestProvider.js.map

package/dist/RequestProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequestProvider.js","sourceRoot":"","sources":["../src/RequestProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EAGb,WAAW,EACX,UAAU,EACV,OAAO,EACP,QAAQ,GACT,MAAM,OAAO,CAAC;AAEf,OAAO,aAAa,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAmBxC,MAAM,qBAAqB,GAAG,aAAa,CACzC,IAAI,CACL,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAAC;AAWzE;;;;;;GAMG;AACH,MAAM,eAAe,GAAgD,CAAC,EACpE,QAAQ,EACR,QAAQ,GAAG,IAAI,EACf,KAAK,EACL,IAAI,GAAG,QAAQ,EACf,OAAO,GACR,EAAE,EAAE;IACH,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAgC,EAAE,CAAC,CAAC;IAE9E,MAAM,WAAW,GAAG,WAAW,CAC7B,CAAC,QAAgB,EAAE,QAAuB,EAAE,EAAE;QAC5C,YAAY,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC9D,CAAC,EACD,EAAE,CACH,CAAC;IAEF,uEAAuE;IACvE,gDAAgD;IAChD,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE;QAC/B,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QACtC,KAAK,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YAC7D,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;IAEvB,MAAM,YAAY,GAAG,OAAO,CAC1B,GAAG,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,EAChD,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,CAAC,CACvC,CAAC;IAEF,OAAO,CACL,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CACzC;MAAA,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,aAAa,CAC9D;IAAA,EAAE,qBAAqB,CAAC,CACzB,CAAC;AACJ,CAAC,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/dist/actionCommands.d.ts

@@ -0,0 +1,32 @@
+import { Action, ApiDocument, HttpMethod } from '@mapples/types';
+/** A follow-up action re-emitted after the request settles. */
+export interface FollowUpAction {
+    type: string;
+    data?: unknown;
+}
+/** A fully-resolved request, ready to execute. */
+export interface RequestCommand {
+    requestId: string;
+    stateKey: string;
+    url: string;
+    method: HttpMethod;
+    headers: Record<string, string>;
+    body?: unknown;
+    responseSample?: unknown;
+    onSuccess?: FollowUpAction;
+    onError?: FollowUpAction;
+}
+/** Everything value resolution may need at emit time. */
+export interface RequestResolutionContext {
+    /** Resolves `state`-kind value sources (a `@mapples/state` lookup). */
+    getStateValue?: (path: string) => unknown;
+    /** Secrets by `secretRef`, resolved by the host — never stored. */
+    secrets?: Record<string, string>;
+}
+/**
+ * Maps a `mapples:request` action to an executable {@link RequestCommand} —
+ * pure and unit-testable; returns null for anything else or when the request
+ * id doesn't resolve.
+ */
+export declare const toRequestCommand: (action: Action, document: ApiDocument, context?: RequestResolutionContext) => RequestCommand | null;
+//# sourceMappingURL=actionCommands.d.ts.map

package/dist/actionCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actionCommands.d.ts","sourceRoot":"","sources":["../src/actionCommands.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,WAAW,EAIX,UAAU,EACX,MAAM,gBAAgB,CAAC;AAKxB,+DAA+D;AAC/D,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,kDAAkD;AAClD,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED,yDAAyD;AACzD,MAAM,WAAW,wBAAwB;IACvC,uEAAuE;IACvE,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAC1C,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AA2FD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,MAAM,EACd,UAAU,WAAW,EACrB,UAAS,wBAA6B,KACrC,cAAc,GAAG,IAiEnB,CAAC"}

package/dist/actionCommands.js

@@ -0,0 +1,113 @@
+import { apiRequestStateKey, } from '@mapples/types';
+import { get, isPlainObject } from 'lodash';
+import { RequestActionType } from './constants';
+const isValueSource = (value) => isPlainObject(value) &&
+    ['static', 'state', 'event'].includes(value.kind ?? '');
+const resolveSource = (source, action, context) => {
+    switch (source.kind) {
+        case 'static':
+            return source.value;
+        case 'state':
+            return context.getStateValue?.(source.dataProp);
+        case 'event': {
+            const payload = action.payload?.data;
+            return source.path ? get(payload, source.path) : payload;
+        }
+    }
+};
+const resolveTemplate = (template, action, context) => {
+    if (isValueSource(template)) {
+        return resolveSource(template, action, context);
+    }
+    if (Array.isArray(template)) {
+        return template.map((entry) => resolveTemplate(entry, action, context));
+    }
+    if (isPlainObject(template)) {
+        const result = {};
+        for (const [key, value] of Object.entries(template)) {
+            result[key] = resolveTemplate(value, action, context);
+        }
+        return result;
+    }
+    return template;
+};
+/** Interpolates `{{variable}}` templates from environment variables. */
+const interpolate = (input, variables) => input.replace(/\{\{([^}]+)\}\}/g, (match, name) => {
+    const value = variables?.[name.trim()];
+    return value !== undefined ? value : match;
+});
+const buildUrl = (request, baseUrl, variables, action, context) => {
+    let path = interpolate(request.path, variables);
+    const query = [];
+    for (const [key, source] of Object.entries(request.params ?? {})) {
+        const value = resolveSource(source, action, context);
+        const encoded = encodeURIComponent(String(value ?? ''));
+        if (path.includes(`{${key}}`)) {
+            path = path.replaceAll(`{${key}}`, encoded);
+        }
+        else {
+            query.push(`${encodeURIComponent(key)}=${encoded}`);
+        }
+    }
+    const absolute = /^https?:\/\//i.test(path)
+        ? path
+        : `${interpolate(baseUrl, variables).replace(/\/$/, '')}${path.startsWith('/') ? '' : '/'}${path}`;
+    return query.length > 0
+        ? `${absolute}${absolute.includes('?') ? '&' : '?'}${query.join('&')}`
+        : absolute;
+};
+/**
+ * Maps a `mapples:request` action to an executable {@link RequestCommand} —
+ * pure and unit-testable; returns null for anything else or when the request
+ * id doesn't resolve.
+ */
+export const toRequestCommand = (action, document, context = {}) => {
+    if (action.type !== RequestActionType.Execute)
+        return null;
+    const data = (action.payload?.data ?? {});
+    if (!data.requestId)
+        return null;
+    const request = document.requests[data.requestId];
+    if (!request)
+        return null;
+    const environment = (document.activeEnvironmentId
+        ? document.environments[document.activeEnvironmentId]
+        : undefined) ?? Object.values(document.environments)[0];
+    const variables = environment?.variables;
+    const headers = {
+        ...environment?.headers,
+        ...request.headers,
+    };
+    for (const [key, value] of Object.entries(headers)) {
+        headers[key] = interpolate(value, variables);
+    }
+    if (request.auth && request.auth.kind !== 'none' && request.auth.secretRef) {
+        const secret = context.secrets?.[request.auth.secretRef];
+        if (secret !== undefined) {
+            if (request.auth.kind === 'bearer') {
+                headers.Authorization = `Bearer ${secret}`;
+            }
+            else {
+                headers[request.auth.header ?? 'Authorization'] = secret;
+            }
+        }
+    }
+    const body = request.body
+        ? resolveTemplate(request.body.template, action, context)
+        : undefined;
+    if (body !== undefined && !headers['Content-Type']) {
+        headers['Content-Type'] = 'application/json';
+    }
+    return {
+        requestId: request.id,
+        stateKey: apiRequestStateKey(request),
+        url: buildUrl(request, environment?.baseUrl ?? '', variables, action, context),
+        method: request.method,
+        headers,
+        body,
+        responseSample: request.responseSample,
+        onSuccess: data.onSuccess,
+        onError: data.onError,
+    };
+};
+//# sourceMappingURL=actionCommands.js.map

package/dist/actionCommands.js.map

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

package/dist/constants.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Action `type` strings handled by the request runtime. Components wire these
+ * to interactions via `actionProps` and emit them through the
+ * `@mapples/action` store.
+ */
+export declare const RequestActionType: {
+    /**
+     * Execute an API request. `payload.data: { requestId, onSuccess?,
+     * onError? }` — the follow-up actions are re-emitted onto the action bus
+     * after the request settles (e.g. a `mapples:navigate`).
+     */
+    readonly Execute: "mapples:request";
+};
+export type RequestActionTypeValue = (typeof RequestActionType)[keyof typeof RequestActionType];
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;IAC5B;;;;OAIG;;CAEK,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAChC,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/constants.js

@@ -0,0 +1,14 @@
+/**
+ * Action `type` strings handled by the request runtime. Components wire these
+ * to interactions via `actionProps` and emit them through the
+ * `@mapples/action` store.
+ */
+export const RequestActionType = {
+    /**
+     * Execute an API request. `payload.data: { requestId, onSuccess?,
+     * onError? }` — the follow-up actions are re-emitted onto the action bus
+     * after the request settles (e.g. a `mapples:navigate`).
+     */
+    Execute: 'mapples:request',
+};
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B;;;;OAIG;IACH,OAAO,EAAE,iBAAiB;CAClB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @fileoverview Runtime for the Mapples `ApiDocument`: executes
+ * `mapples:request` actions (sample or real fetch), publishes responses into
+ * `@mapples/state`, and chains follow-up actions on the action bus.
+ */
+export { default as RequestProvider } from './RequestProvider';
+export { useRequestRuntime } from './RequestProvider';
+export type { RequestExecutionMode, RequestProviderProps, RequestRuntimeContextType, ResponseState, } from './RequestProvider';
+export { default as RequestActionHandler } from './RequestActionHandler';
+export * from './actionCommands';
+export * from './constants';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,YAAY,EACV,oBAAoB,EACpB,oBAAoB,EACpB,yBAAyB,EACzB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAEzE,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+/**
+ * @fileoverview Runtime for the Mapples `ApiDocument`: executes
+ * `mapples:request` actions (sample or real fetch), publishes responses into
+ * `@mapples/state`, and chains follow-up actions on the action bus.
+ */
+export { default as RequestProvider } from './RequestProvider';
+export { useRequestRuntime } from './RequestProvider';
+export { default as RequestActionHandler } from './RequestActionHandler';
+export * from './actionCommands';
+export * from './constants';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAOtD,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAEzE,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@mapples/request",
+  "version": "0.1.0",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc -b tsconfig.build.json",
+    "lint": "eslint .",
+    "type-check": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "author": {
+    "name": "Oleksandr Soloviov",
+    "url": "https://mapples.org/people/olek_soloviov"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mapplesorg/mapples-open-kit.git",
+    "directory": "packages/@mapples/request"
+  },
+  "peerDependencies": {
+    "@mapples/action": "*",
+    "@mapples/state": "*",
+    "@mapples/types": "*",
+    "lodash": "^4.18.0",
+    "react": ">=18.0.0 <20.0.0",
+    "rxjs": "^7.0.0"
+  },
+  "devDependencies": {
+    "@types/react": ">=18.0.0 <20.0.0",
+    "typescript": "~6.0.3"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "package.json"
+  ]
+}