@nexo-alpha/data 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nexo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/client.d.ts

@@ -0,0 +1,71 @@
+/**
+ * @nexo-alpha/data — typed resource client & proxy.
+ *
+ * Provides typed, codegen-free client access to server `resource()` definitions:
+ *
+ * @example
+ * ```ts
+ * // Using NexoClient or any HTTP adapter
+ * const api = createResourcesProxy<{ users: typeof User }>(client);
+ *
+ * const { items, total } = await api.users.list({ limit: 10 });
+ * const user = await api.users.create({ name: "Alice", email: "alice@example.com" });
+ * const updated = await api.users.update(user.id, { age: 30 });
+ * await api.users.delete(user.id);
+ * ```
+ */
+import type { Fields, Infer } from "./fields.js";
+import type { Entity, ListQuery, Page } from "./store.js";
+import type { Resource } from "./resource.js";
+export interface NexoHttpClientLike {
+    api?<T = unknown>(path: string, init?: RequestInit): Promise<T>;
+    get?<T = unknown>(path: string): Promise<T>;
+    post?<T = unknown>(path: string, body?: unknown, init?: RequestInit): Promise<T>;
+    patch?<T = unknown>(path: string, body?: unknown, init?: RequestInit): Promise<T>;
+    delete?<T = unknown>(path: string, init?: RequestInit): Promise<T>;
+}
+export interface ClientConnectionOptions {
+    readonly baseUrl?: string;
+    readonly headers?: Record<string, string>;
+    readonly fetch?: typeof fetch;
+}
+export type ClientTarget = NexoHttpClientLike | ClientConnectionOptions;
+export declare function encodeListQuery<T>(query?: ListQuery<T>): string;
+export interface ResourceClient<F extends Fields> {
+    /** The collection URL path, e.g. `"/users"`. */
+    readonly path: string;
+    /** Fetch a paginated list of records. */
+    list(query?: ListQuery<Infer<F>>): Promise<Page<Entity<Infer<F>>>>;
+    /** Fetch a single record by id. Throws on 404. */
+    get(id: string): Promise<Entity<Infer<F>>>;
+    /** Create a new record. */
+    create(data: Infer<F>): Promise<Entity<Infer<F>>>;
+    /** Partially update an existing record. */
+    update(id: string, patch: Partial<Infer<F>>): Promise<Entity<Infer<F>>>;
+    /** Delete a record by id. */
+    delete(id: string): Promise<void>;
+}
+/**
+ * Creates a standalone `ResourceClient` for a given `Resource` definition or path.
+ */
+export declare function createResourceClient<F extends Fields>(resourceOrPath: Resource<F> | string, target?: ClientTarget): ResourceClient<F>;
+export type ResourceRegistry = Record<string, Resource<any>>;
+export type ResourcesProxy<R extends ResourceRegistry> = {
+    [K in keyof R]: R[K] extends Resource<infer F> ? ResourceClient<F> : never;
+};
+/**
+ * Creates a typed proxy mapping resource names to their corresponding `ResourceClient`.
+ *
+ * Can be called with generic type inference:
+ * ```ts
+ * const api = createResourcesProxy<{ users: typeof User }>(client);
+ * const page = await api.users.list();
+ * ```
+ *
+ * Or by passing runtime resource instances:
+ * ```ts
+ * const api = createResourcesProxy(client, { users: User });
+ * ```
+ */
+export declare function createResourcesProxy<R extends ResourceRegistry>(target?: ClientTarget, map?: R): ResourcesProxy<R>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -0,0 +1,192 @@
+/**
+ * @nexo-alpha/data — typed resource client & proxy.
+ *
+ * Provides typed, codegen-free client access to server `resource()` definitions:
+ *
+ * @example
+ * ```ts
+ * // Using NexoClient or any HTTP adapter
+ * const api = createResourcesProxy<{ users: typeof User }>(client);
+ *
+ * const { items, total } = await api.users.list({ limit: 10 });
+ * const user = await api.users.create({ name: "Alice", email: "alice@example.com" });
+ * const updated = await api.users.update(user.id, { age: 30 });
+ * await api.users.delete(user.id);
+ * ```
+ */
+function resolveCaller(target) {
+    if (target !== undefined && ("api" in target || "get" in target)) {
+        const client = target;
+        return {
+            get: async (path) => {
+                if (typeof client.get === "function")
+                    return client.get(path);
+                if (typeof client.api === "function")
+                    return client.api(path, { method: "GET" });
+                throw new Error("Target client does not implement get() or api().");
+            },
+            post: async (path, body) => {
+                if (typeof client.post === "function")
+                    return client.post(path, body);
+                if (typeof client.api === "function") {
+                    return client.api(path, {
+                        method: "POST",
+                        headers: { "Content-Type": "application/json" },
+                        body: JSON.stringify(body)
+                    });
+                }
+                throw new Error("Target client does not implement post() or api().");
+            },
+            patch: async (path, body) => {
+                if (typeof client.patch === "function")
+                    return client.patch(path, body);
+                if (typeof client.api === "function") {
+                    return client.api(path, {
+                        method: "PATCH",
+                        headers: { "Content-Type": "application/json" },
+                        body: JSON.stringify(body)
+                    });
+                }
+                throw new Error("Target client does not implement patch() or api().");
+            },
+            delete: async (path) => {
+                if (typeof client.delete === "function")
+                    return client.delete(path);
+                if (typeof client.api === "function")
+                    return client.api(path, { method: "DELETE" });
+                throw new Error("Target client does not implement delete() or api().");
+            }
+        };
+    }
+    const opts = target ?? {};
+    const baseUrl = (opts.baseUrl ?? "").replace(/\/+$/, "");
+    const fetchFn = opts.fetch ?? (typeof globalThis.fetch === "function" ? globalThis.fetch.bind(globalThis) : fetch);
+    const defaultHeaders = {
+        "Accept": "application/json",
+        ...(opts.headers ?? {})
+    };
+    const request = async (path, init) => {
+        const cleanPath = path.startsWith("/") ? path : `/${path}`;
+        const url = /^https?:\/\//i.test(path) ? path : `${baseUrl}${cleanPath}`;
+        const res = await fetchFn(url, {
+            ...init,
+            headers: {
+                ...defaultHeaders,
+                ...init?.headers
+            }
+        });
+        if (!res.ok) {
+            let payload;
+            let msg = `HTTP ${res.status} ${res.statusText}`;
+            try {
+                payload = await res.json();
+                if (payload && typeof payload === "object" && "error" in payload) {
+                    msg = String(payload.error);
+                }
+            }
+            catch {
+                // Not JSON
+            }
+            const err = new Error(msg);
+            err.status = res.status;
+            err.payload = payload;
+            throw err;
+        }
+        if (res.status === 204) {
+            return undefined;
+        }
+        return (await res.json());
+    };
+    return {
+        get: (path) => request(path, { method: "GET" }),
+        post: (path, body) => request(path, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(body)
+        }),
+        patch: (path, body) => request(path, {
+            method: "PATCH",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(body)
+        }),
+        delete: (path) => request(path, { method: "DELETE" })
+    };
+}
+// ---------------------------------------------------------------------------
+// List query encoder
+// ---------------------------------------------------------------------------
+export function encodeListQuery(query = {}) {
+    const params = new URLSearchParams();
+    if (query.limit !== undefined)
+        params.set("limit", String(query.limit));
+    if (query.cursor !== undefined)
+        params.set("cursor", query.cursor);
+    if (query.sort !== undefined)
+        params.set("sort", query.sort);
+    if (query.where !== undefined) {
+        for (const [key, val] of Object.entries(query.where)) {
+            if (val !== undefined && val !== null) {
+                params.set(`where[${key}]`, String(val));
+            }
+        }
+    }
+    return params.toString();
+}
+/**
+ * Creates a standalone `ResourceClient` for a given `Resource` definition or path.
+ */
+export function createResourceClient(resourceOrPath, target) {
+    const path = (typeof resourceOrPath === "string" ? resourceOrPath : resourceOrPath.path).replace(/\/+$/, "");
+    const caller = resolveCaller(target);
+    return {
+        path,
+        list: async (query) => {
+            const qs = query ? encodeListQuery(query) : "";
+            return caller.get(qs ? `${path}?${qs}` : path);
+        },
+        get: async (id) => {
+            return caller.get(`${path}/${encodeURIComponent(id)}`);
+        },
+        create: async (data) => {
+            return caller.post(path, data);
+        },
+        update: async (id, patch) => {
+            return caller.patch(`${path}/${encodeURIComponent(id)}`, patch);
+        },
+        delete: async (id) => {
+            await caller.delete(`${path}/${encodeURIComponent(id)}`);
+        }
+    };
+}
+/**
+ * Creates a typed proxy mapping resource names to their corresponding `ResourceClient`.
+ *
+ * Can be called with generic type inference:
+ * ```ts
+ * const api = createResourcesProxy<{ users: typeof User }>(client);
+ * const page = await api.users.list();
+ * ```
+ *
+ * Or by passing runtime resource instances:
+ * ```ts
+ * const api = createResourcesProxy(client, { users: User });
+ * ```
+ */
+export function createResourcesProxy(target, map) {
+    const cache = new Map();
+    return new Proxy({}, {
+        get(_target, prop) {
+            if (typeof prop !== "string")
+                return undefined;
+            let cached = cache.get(prop);
+            if (cached)
+                return cached;
+            const resourceDef = map?.[prop];
+            const resourcePath = resourceDef?.path ?? `/${prop.replace(/([A-Z])/g, "-$1").toLowerCase()}`;
+            cached = createResourceClient(resourcePath, target);
+            cache.set(prop, cached);
+            return cached;
+        }
+    });
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/fields.d.ts

@@ -0,0 +1,115 @@
+/**
+ * @nexo-alpha/data — typed schema builder.
+ *
+ * Each `Field<T>` carries the TypeScript type as a phantom and emits a
+ * `NexoFieldSchema` at runtime, keeping `core`'s "schema is data" rule and
+ * giving full inference.
+ *
+ * @example
+ * ```ts
+ * import { string, email, number, boolean, Fields, Infer } from "@nexo-alpha/data";
+ *
+ * const UserFields = {
+ *   name:  string({ min: 1, max: 100 }),
+ *   email: email(),
+ *   age:   number({ min: 0, int: true }).optional(),
+ *   admin: boolean(),
+ * };
+ *
+ * type User = Infer<typeof UserFields>;
+ * //   { name: string; email: string; age?: number; admin: boolean }
+ * ```
+ */
+import type { NexoFieldSchema } from "@nexo-alpha/core";
+/**
+ * A field descriptor: `_t` is the compile-time type (phantom, never read at
+ * runtime). `schema` is the `NexoFieldSchema` emitted for validation,
+ * OpenAPI generation, and client inference. `required` tracks whether
+ * `.optional()` has been called.
+ */
+export interface Field<T> {
+    /** @internal — phantom, never present at runtime */
+    readonly _t: T;
+    readonly schema: NexoFieldSchema;
+    readonly required: boolean;
+    /** Returns a new `Field` where the value may be `undefined`. */
+    optional(): Field<T | undefined>;
+}
+/** A record of named field descriptors — the shape declaration for a resource. */
+export type Fields = Record<string, Field<unknown>>;
+/**
+ * Extracts required fields (those where `required` is `true`) from a
+ * `Fields` map. Used to build the two-part mapped type in `Infer`.
+ */
+type RequiredKeys<F extends Fields> = {
+    [K in keyof F]: F[K] extends Field<infer T> ? undefined extends T ? never : K : never;
+}[keyof F];
+type OptionalKeys<F extends Fields> = Exclude<keyof F, RequiredKeys<F>>;
+/**
+ * Converts a `Fields` record to the TypeScript object type it describes,
+ * with optional fields (those decorated with `.optional()`) as `?: T`.
+ *
+ * @example
+ * ```ts
+ * type User = Infer<typeof UserFields>;
+ * ```
+ */
+export type Infer<F extends Fields> = {
+    [K in RequiredKeys<F>]: F[K] extends Field<infer T> ? T : never;
+} & {
+    [K in OptionalKeys<F>]?: F[K] extends Field<infer T> ? Exclude<T, undefined> : never;
+};
+export interface StringOptions {
+    /** Minimum character length (inclusive). */
+    readonly min?: number;
+    /** Maximum character length (inclusive). */
+    readonly max?: number;
+    /** Regex or string pattern the value must satisfy. */
+    readonly pattern?: string | RegExp;
+    /** Allowed values. */
+    readonly enum?: readonly string[];
+    /** Free-form description forwarded to OpenAPI. */
+    readonly description?: string;
+}
+/** A required `string` field. Call `.optional()` to make it optional. */
+export declare function string(options?: StringOptions): Field<string>;
+/** A required `string` field pre-configured with a basic e-mail pattern. */
+export declare function email(options?: Pick<StringOptions, "description">): Field<string>;
+export interface NumberOptions {
+    /** Minimum value (inclusive). */
+    readonly min?: number;
+    /** Maximum value (inclusive). */
+    readonly max?: number;
+    /** Require an integer value. */
+    readonly int?: boolean;
+    readonly description?: string;
+}
+/** A required `number` field. Call `.optional()` to make it optional. */
+export declare function number(options?: NumberOptions): Field<number>;
+/** A required `boolean` field. Call `.optional()` to make it optional. */
+export declare function boolean(options?: {
+    readonly description?: string;
+}): Field<boolean>;
+/**
+ * Converts a `Fields` map into the `properties` object expected by a
+ * `NexoFieldSchema` of `type: "object"`.
+ *
+ * The `required` flag is stripped from individual property schemas for
+ * optional fields — the object-level `required` array (built by
+ * `requiredFieldNames`) is the sole authority for which properties are
+ * mandatory. Leaving `required: true` on an optional property schema would
+ * cause `validateField` to reject a valid request where that field is absent.
+ */
+export declare function fieldsToProperties(fields: Fields): Record<string, NexoFieldSchema>;
+/**
+ * Returns the names of all required fields (i.e. those whose `.required` is
+ * `true`) — used as the `required` array on the body schema.
+ */
+export declare function requiredFieldNames(fields: Fields): readonly string[];
+/**
+ * Returns a copy of `fields` where every field is optional — used for the
+ * PATCH (partial update) body schema.
+ */
+export declare function allOptional(fields: Fields): Fields;
+export {};
+//# sourceMappingURL=fields.d.ts.map

package/dist/fields.d.ts.map

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

package/dist/fields.js

@@ -0,0 +1,127 @@
+/**
+ * @nexo-alpha/data — typed schema builder.
+ *
+ * Each `Field<T>` carries the TypeScript type as a phantom and emits a
+ * `NexoFieldSchema` at runtime, keeping `core`'s "schema is data" rule and
+ * giving full inference.
+ *
+ * @example
+ * ```ts
+ * import { string, email, number, boolean, Fields, Infer } from "@nexo-alpha/data";
+ *
+ * const UserFields = {
+ *   name:  string({ min: 1, max: 100 }),
+ *   email: email(),
+ *   age:   number({ min: 0, int: true }).optional(),
+ *   admin: boolean(),
+ * };
+ *
+ * type User = Infer<typeof UserFields>;
+ * //   { name: string; email: string; age?: number; admin: boolean }
+ * ```
+ */
+// ---------------------------------------------------------------------------
+// Internal factory
+// ---------------------------------------------------------------------------
+function makeField(schema, req) {
+    return {
+        _t: undefined,
+        schema,
+        required: req,
+        optional() {
+            return makeField({ ...schema }, false);
+        }
+    };
+}
+/** A required `string` field. Call `.optional()` to make it optional. */
+export function string(options = {}) {
+    const schema = {
+        type: "string",
+        required: true,
+        ...(options.min !== undefined ? { minLength: options.min } : {}),
+        ...(options.max !== undefined ? { maxLength: options.max } : {}),
+        ...(options.pattern !== undefined ? { pattern: options.pattern } : {}),
+        ...(options.enum !== undefined ? { enum: options.enum } : {}),
+        ...(options.description !== undefined ? { description: options.description } : {})
+    };
+    return makeField(schema, true);
+}
+/** A required `string` field pre-configured with a basic e-mail pattern. */
+export function email(options = {}) {
+    return string({
+        // Simple RFC-5321-ish pattern — enough for a server-side sanity check.
+        pattern: /^[^\s@]+@[^\s@]+\.[^\s@]+$/,
+        description: options.description ?? "Email address",
+        max: 320
+    });
+}
+/** A required `number` field. Call `.optional()` to make it optional. */
+export function number(options = {}) {
+    const schema = {
+        type: "number",
+        required: true,
+        ...(options.min !== undefined ? { min: options.min } : {}),
+        ...(options.max !== undefined ? { max: options.max } : {}),
+        ...(options.int !== undefined ? { integer: options.int } : {}),
+        ...(options.description !== undefined ? { description: options.description } : {})
+    };
+    return makeField(schema, true);
+}
+/** A required `boolean` field. Call `.optional()` to make it optional. */
+export function boolean(options = {}) {
+    const schema = {
+        type: "boolean",
+        required: true,
+        ...(options.description !== undefined ? { description: options.description } : {})
+    };
+    return makeField(schema, true);
+}
+// ---------------------------------------------------------------------------
+// Helpers consumed by resource.ts
+// ---------------------------------------------------------------------------
+/**
+ * Converts a `Fields` map into the `properties` object expected by a
+ * `NexoFieldSchema` of `type: "object"`.
+ *
+ * The `required` flag is stripped from individual property schemas for
+ * optional fields — the object-level `required` array (built by
+ * `requiredFieldNames`) is the sole authority for which properties are
+ * mandatory. Leaving `required: true` on an optional property schema would
+ * cause `validateField` to reject a valid request where that field is absent.
+ */
+export function fieldsToProperties(fields) {
+    const props = {};
+    for (const [key, field] of Object.entries(fields)) {
+        if (field.required) {
+            props[key] = field.schema;
+        }
+        else {
+            // Omit the required key entirely for optional fields.
+            // eslint-disable-next-line @typescript-eslint/no-unused-vars
+            const { required: _r, ...rest } = field.schema;
+            props[key] = rest;
+        }
+    }
+    return props;
+}
+/**
+ * Returns the names of all required fields (i.e. those whose `.required` is
+ * `true`) — used as the `required` array on the body schema.
+ */
+export function requiredFieldNames(fields) {
+    return Object.entries(fields)
+        .filter(([, f]) => f.required)
+        .map(([k]) => k);
+}
+/**
+ * Returns a copy of `fields` where every field is optional — used for the
+ * PATCH (partial update) body schema.
+ */
+export function allOptional(fields) {
+    const result = {};
+    for (const [key, field] of Object.entries(fields)) {
+        result[key] = field.optional();
+    }
+    return result;
+}
+//# sourceMappingURL=fields.js.map

package/dist/fields.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @nexo-alpha/data — public surface.
+ *
+ * @example
+ * ```ts
+ * import { resource, string, email, number, boolean } from "@nexo-alpha/data";
+ * ```
+ */
+export { string, email, number, boolean, fieldsToProperties, requiredFieldNames, allOptional } from "./fields.js";
+export type { Field, Fields, Infer } from "./fields.js";
+export { memoryStore } from "./store.js";
+export type { Entity, ListQuery, Page, ResourceStore } from "./store.js";
+export { resource } from "./resource.js";
+export type { Operation, OperationAuth, Resource, ResourceDescription, ResourceFieldDetail, ResourceEmitter, ResourceOptions } from "./resource.js";
+export { createResourceClient, createResourcesProxy, encodeListQuery } from "./client.js";
+export type { ClientConnectionOptions, ClientTarget, NexoHttpClientLike, ResourceClient, ResourceRegistry, ResourcesProxy } from "./client.js";
+//# 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;;;;;;;GAOG;AAGH,OAAO,EACL,MAAM,EACN,KAAK,EACL,MAAM,EACN,OAAO,EACP,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,EACZ,MAAM,aAAa,CAAC;AAErB,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGxD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,YAAY,EACV,MAAM,EACN,SAAS,EACT,IAAI,EACJ,aAAa,EACd,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,YAAY,EACV,SAAS,EACT,aAAa,EACb,QAAQ,EACR,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,eAAe,EAChB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EAChB,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,uBAAuB,EACvB,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACf,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+/**
+ * @nexo-alpha/data — public surface.
+ *
+ * @example
+ * ```ts
+ * import { resource, string, email, number, boolean } from "@nexo-alpha/data";
+ * ```
+ */
+// --- Schema builder ---------------------------------------------------------
+export { string, email, number, boolean, fieldsToProperties, requiredFieldNames, allOptional } from "./fields.js";
+// --- Storage -----------------------------------------------------------------
+export { memoryStore } from "./store.js";
+// --- Resource ----------------------------------------------------------------
+export { resource } from "./resource.js";
+// --- Client ------------------------------------------------------------------
+export { createResourceClient, createResourcesProxy, encodeListQuery } from "./client.js";
+//# 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;;;;;;;GAOG;AAEH,+EAA+E;AAC/E,OAAO,EACL,MAAM,EACN,KAAK,EACL,MAAM,EACN,OAAO,EACP,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,EACZ,MAAM,aAAa,CAAC;AAIrB,gFAAgF;AAChF,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AASzC,gFAAgF;AAChF,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAYzC,gFAAgF;AAChF,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EAChB,MAAM,aAAa,CAAC"}