@nexo-alpha/data 0.0.0-stage → 0.1.0

package/dist/resource.d.ts

@@ -0,0 +1,119 @@
+/**
+ * @nexo-alpha/data — resource() factory.
+ *
+ * Generates five CRUD `NexoApi` objects from a `Fields` map and wires them
+ * to a `ResourceStore`. The Hapi adapter picks up the resulting module
+ * unchanged — no modifications to `@nexo-alpha/hapi` required.
+ *
+ * @example
+ * ```ts
+ * import { resource, string, email, number } from "@nexo-alpha/data";
+ *
+ * export const User = resource("User", {
+ *   name:  string({ min: 1 }),
+ *   email: email(),
+ *   age:   number().optional(),
+ * }, { auth: { scopes: ["users:read", "users:write"] } });
+ *
+ * app.module(User.module());
+ * ```
+ */
+import { type NexoApi, type NexoModule } from "@nexo-alpha/core";
+import { type Fields, type Infer } from "./fields.js";
+import { type Entity, type ListQuery, type Page, type ResourceStore } from "./store.js";
+export interface ResourceEmitter {
+    emit(event: string, payload: unknown): void | Promise<void>;
+}
+export type Operation = "list" | "get" | "create" | "update" | "delete";
+export interface OperationAuth {
+    readonly scopes?: readonly string[];
+}
+export interface ResourceOptions<T> {
+    /**
+     * URL path for the collection. Defaults to `"/<plural-kebab-name>"`.
+     * Override when the default pluralisation is wrong:
+     * `{ path: "/people" }`.
+     */
+    readonly path?: string;
+    /**
+     * Default auth applied to all operations. Individual operations can
+     * override this via `operationAuth`.
+     */
+    readonly auth?: {
+        readonly scopes?: readonly string[];
+    };
+    /**
+     * Per-operation scope overrides. If omitted, falls back to the top-level
+     * `auth.scopes`.
+     */
+    readonly operationAuth?: Partial<Record<Operation, OperationAuth>>;
+    /**
+     * Expose only a subset of the five CRUD operations.
+     * Default: all five.
+     */
+    readonly operations?: readonly Operation[];
+    /**
+     * Provide an alternative store (Drizzle, Prisma, etc.).
+     * Default: `memoryStore()`.
+     */
+    readonly store?: ResourceStore<T>;
+    /**
+     * Event emitter for domain events (`user.created`, …).
+     * Default: no-op — safe to wire to `@nexo-alpha/events` later.
+     */
+    readonly events?: ResourceEmitter;
+}
+export interface ResourceFieldDetail {
+    readonly name: string;
+    readonly type: string;
+    readonly required: boolean;
+}
+export interface ResourceDescription {
+    readonly model: string;
+    readonly path: string;
+    readonly fields: readonly string[];
+    readonly fieldDetails?: readonly ResourceFieldDetail[];
+    readonly operations: readonly Operation[];
+    readonly scopes: readonly string[];
+    readonly events: readonly string[];
+    readonly store: string;
+}
+export interface Resource<F extends Fields> {
+    /** Resource name, e.g. `"User"`. */
+    readonly name: string;
+    /** Collection path, e.g. `"/users"`. */
+    readonly path: string;
+    /** The field descriptor map passed to `resource()`. */
+    readonly fields: F;
+    /** Raw store access — the only part that changes per database adapter. */
+    readonly store: ResourceStore<Infer<F>>;
+    list(query?: ListQuery<Infer<F>>): Promise<Page<Entity<Infer<F>>>>;
+    get(id: string): Promise<Entity<Infer<F>>>;
+    create(data: Infer<F>): Promise<Entity<Infer<F>>>;
+    update(id: string, patch: Partial<Infer<F>>): Promise<Entity<Infer<F>>>;
+    delete(id: string): Promise<void>;
+    /** Returns the five (or fewer) `NexoApi` objects registered by `module()`. */
+    apis(): readonly NexoApi[];
+    /** Returns a `NexoModule` ready to be passed to `app.module()`. */
+    module(): NexoModule;
+    /** Powers `nexo inspect <Resource>`. */
+    describe(): ResourceDescription;
+}
+/**
+ * Declares a CRUD resource.
+ *
+ * @param name    PascalCase model name (`"User"`, `"BlogPost"`)
+ * @param fields  Field descriptor map built with `string()`, `email()`, etc.
+ * @param options Optional: path override, auth scopes, per-op auth, store
+ *
+ * @example
+ * ```ts
+ * export const User = resource("User", {
+ *   name:  string({ min: 1 }),
+ *   email: email(),
+ *   age:   number().optional(),
+ * }, { auth: { scopes: ["users:read", "users:write"] } });
+ * ```
+ */
+export declare function resource<F extends Fields>(name: string, fields: F, options?: ResourceOptions<Infer<F>>): Resource<F>;
+//# sourceMappingURL=resource.d.ts.map

package/dist/resource.d.ts.map

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

package/dist/resource.js

@@ -0,0 +1,289 @@
+/**
+ * @nexo-alpha/data — resource() factory.
+ *
+ * Generates five CRUD `NexoApi` objects from a `Fields` map and wires them
+ * to a `ResourceStore`. The Hapi adapter picks up the resulting module
+ * unchanged — no modifications to `@nexo-alpha/hapi` required.
+ *
+ * @example
+ * ```ts
+ * import { resource, string, email, number } from "@nexo-alpha/data";
+ *
+ * export const User = resource("User", {
+ *   name:  string({ min: 1 }),
+ *   email: email(),
+ *   age:   number().optional(),
+ * }, { auth: { scopes: ["users:read", "users:write"] } });
+ *
+ * app.module(User.module());
+ * ```
+ */
+import { NexoHttpError, httpResponse } from "@nexo-alpha/core";
+import { fieldsToProperties, requiredFieldNames, allOptional } from "./fields.js";
+import { memoryStore } from "./store.js";
+const NOOP_EMITTER = { emit: () => undefined };
+// ---------------------------------------------------------------------------
+// Utility: simple pluralisation + kebab-case
+// ---------------------------------------------------------------------------
+function toKebab(name) {
+    return name
+        .replace(/([A-Z])/g, (m, ch, i) => (i > 0 ? "-" : "") + ch.toLowerCase())
+        .replace(/^-/, "");
+}
+function pluralise(word) {
+    if (word.endsWith("y") && !/[aeiou]y$/.test(word))
+        return word.slice(0, -1) + "ies";
+    if (word.endsWith("s") ||
+        word.endsWith("x") ||
+        word.endsWith("z") ||
+        word.endsWith("ch") ||
+        word.endsWith("sh")) {
+        return word + "es";
+    }
+    return word + "s";
+}
+// ---------------------------------------------------------------------------
+// API builder helpers
+// ---------------------------------------------------------------------------
+/** Builds the body `NexoFieldSchema` for CREATE (all required fields). */
+function bodySchema(fields) {
+    // Use Field.required (the user-facing flag) not schema.required (which is
+    // always true inside the NexoFieldSchema descriptor itself).
+    const reqNames = requiredFieldNames(fields);
+    return {
+        type: "object",
+        ...(reqNames.length > 0 ? { required: reqNames } : {}),
+        properties: fieldsToProperties(fields)
+    };
+}
+/** Builds the body `NexoFieldSchema` for PATCH (all fields optional). */
+function patchBodySchema(fields) {
+    return {
+        type: "object",
+        properties: fieldsToProperties(allOptional(fields))
+    };
+}
+/**
+ * Returns the spread-safe auth fragment for a NexoApi literal.
+ * Returns `{}` (no auth key) when scopes is empty, so `exactOptionalPropertyTypes`
+ * is satisfied — spreading `{}` omits the key entirely.
+ */
+function authSpread(op, topScopes, overrides) {
+    const scopes = overrides[op]?.scopes ?? topScopes;
+    if (scopes.length === 0)
+        return {};
+    return { auth: { required: true, scopes } };
+}
+// ---------------------------------------------------------------------------
+// Main factory
+// ---------------------------------------------------------------------------
+/**
+ * Declares a CRUD resource.
+ *
+ * @param name    PascalCase model name (`"User"`, `"BlogPost"`)
+ * @param fields  Field descriptor map built with `string()`, `email()`, etc.
+ * @param options Optional: path override, auth scopes, per-op auth, store
+ *
+ * @example
+ * ```ts
+ * export const User = resource("User", {
+ *   name:  string({ min: 1 }),
+ *   email: email(),
+ *   age:   number().optional(),
+ * }, { auth: { scopes: ["users:read", "users:write"] } });
+ * ```
+ */
+export function resource(name, fields, options = {}) {
+    const collectionPath = options.path ?? `/${pluralise(toKebab(name))}`;
+    const itemPath = `${collectionPath}/:id`;
+    const topScopes = options.auth?.scopes ?? [];
+    const opAuth = options.operationAuth ?? {};
+    const enabledOps = options.operations ?? ["list", "get", "create", "update", "delete"];
+    const store = options.store ??
+        memoryStore();
+    const emitter = options.events ?? NOOP_EMITTER;
+    // Derive event names once
+    const lower = name.toLowerCase();
+    // -------------------------------------------------------------------------
+    // API handlers
+    // -------------------------------------------------------------------------
+    const listApi = {
+        name: `${lower}s.list`,
+        method: "GET",
+        path: collectionPath,
+        description: `List ${name} records`,
+        schema: {
+            query: {
+                limit: { type: "number", integer: true, min: 1, max: 200 },
+                cursor: { type: "string" },
+                sort: { type: "string" }
+            }
+        },
+        ...authSpread("list", topScopes, opAuth),
+        handler: async (ctx) => {
+            const q = ctx.query;
+            // Build query omitting keys that are absent (exactOptionalPropertyTypes)
+            const query = {
+                ...(q["limit"] !== undefined ? { limit: Number(q["limit"]) } : {}),
+                ...(typeof q["cursor"] === "string" ? { cursor: q["cursor"] } : {}),
+                ...(typeof q["sort"] === "string" ? { sort: q["sort"] } : {})
+            };
+            return store.list(query);
+        }
+    };
+    const getApi = {
+        name: `${lower}s.get`,
+        method: "GET",
+        path: itemPath,
+        description: `Get a single ${name} by id`,
+        schema: { params: { id: { type: "string", required: true } } },
+        ...authSpread("get", topScopes, opAuth),
+        handler: async (ctx) => {
+            const id = ctx.params["id"];
+            if (!id)
+                throw new NexoHttpError(400, "MISSING_ID", "id param is required.");
+            const entity = await store.get(id);
+            if (entity === null) {
+                throw new NexoHttpError(404, `${name.toUpperCase()}_NOT_FOUND`, `${name} "${id}" not found.`);
+            }
+            return entity;
+        }
+    };
+    const createApi = {
+        name: `${lower}s.create`,
+        method: "POST",
+        path: collectionPath,
+        description: `Create a ${name}`,
+        schema: { body: bodySchema(fields) },
+        ...authSpread("create", topScopes, opAuth),
+        handler: async (ctx) => {
+            const data = ctx.payload;
+            const entity = await store.create(data);
+            await emitter.emit(`${lower}.created`, entity);
+            return httpResponse(201, entity);
+        }
+    };
+    const updateApi = {
+        name: `${lower}s.update`,
+        method: "PATCH",
+        path: itemPath,
+        description: `Partially update a ${name}`,
+        schema: {
+            params: { id: { type: "string", required: true } },
+            body: patchBodySchema(fields)
+        },
+        ...authSpread("update", topScopes, opAuth),
+        handler: async (ctx) => {
+            const id = ctx.params["id"];
+            if (!id)
+                throw new NexoHttpError(400, "MISSING_ID", "id param is required.");
+            const patch = ctx.payload;
+            const entity = await store.update(id, patch);
+            if (entity === null) {
+                throw new NexoHttpError(404, `${name.toUpperCase()}_NOT_FOUND`, `${name} "${id}" not found.`);
+            }
+            await emitter.emit(`${lower}.updated`, entity);
+            return entity;
+        }
+    };
+    const deleteApi = {
+        name: `${lower}s.delete`,
+        method: "DELETE",
+        path: itemPath,
+        description: `Delete a ${name}`,
+        schema: { params: { id: { type: "string", required: true } } },
+        ...authSpread("delete", topScopes, opAuth),
+        handler: async (ctx) => {
+            const id = ctx.params["id"];
+            if (!id)
+                throw new NexoHttpError(400, "MISSING_ID", "id param is required.");
+            const deleted = await store.delete(id);
+            if (!deleted) {
+                throw new NexoHttpError(404, `${name.toUpperCase()}_NOT_FOUND`, `${name} "${id}" not found.`);
+            }
+            await emitter.emit(`${lower}.deleted`, { id });
+            return httpResponse(204);
+        }
+    };
+    const ALL_APIS = {
+        list: listApi,
+        get: getApi,
+        create: createApi,
+        update: updateApi,
+        delete: deleteApi
+    };
+    // -------------------------------------------------------------------------
+    // Public Resource object
+    // -------------------------------------------------------------------------
+    const self = {
+        name,
+        path: collectionPath,
+        fields,
+        store,
+        // High-level helpers
+        list: (query) => store.list(query ?? {}),
+        get: async (id) => {
+            const e = await store.get(id);
+            if (e === null)
+                throw new NexoHttpError(404, `${name.toUpperCase()}_NOT_FOUND`, `${name} "${id}" not found.`);
+            return e;
+        },
+        create: async (data) => {
+            const entity = await store.create(data);
+            await emitter.emit(`${lower}.created`, entity);
+            return entity;
+        },
+        update: async (id, patch) => {
+            const e = await store.update(id, patch);
+            if (e === null)
+                throw new NexoHttpError(404, `${name.toUpperCase()}_NOT_FOUND`, `${name} "${id}" not found.`);
+            await emitter.emit(`${lower}.updated`, e);
+            return e;
+        },
+        delete: async (id) => {
+            const deleted = await store.delete(id);
+            if (!deleted)
+                throw new NexoHttpError(404, `${name.toUpperCase()}_NOT_FOUND`, `${name} "${id}" not found.`);
+            await emitter.emit(`${lower}.deleted`, { id });
+        },
+        apis() {
+            return enabledOps.map((op) => ALL_APIS[op]);
+        },
+        module() {
+            return {
+                name: `${lower}s`,
+                description: `CRUD module for ${name}`,
+                apis: self.apis(),
+                describe: () => self.describe(),
+                resource: self
+            };
+        },
+        describe() {
+            const scopes = [...new Set(topScopes)];
+            const fieldDetails = [
+                { name: "id", type: "string", required: true },
+                ...Object.entries(fields).map(([fieldName, f]) => ({
+                    name: fieldName,
+                    type: f.schema.type,
+                    required: f.required
+                })),
+                { name: "createdAt", type: "string", required: true },
+                { name: "updatedAt", type: "string", required: true }
+            ];
+            return {
+                model: name,
+                path: collectionPath,
+                fields: ["id", ...Object.keys(fields), "createdAt", "updatedAt"],
+                fieldDetails,
+                operations: enabledOps,
+                scopes,
+                events: enabledOps
+                    .filter((op) => op !== "list" && op !== "get")
+                    .map((op) => `${lower}.${op === "create" ? "created" : op === "update" ? "updated" : "deleted"}`),
+                store: options.store !== undefined ? "custom" : "memory"
+            };
+        }
+    };
+    return self;
+}
+//# sourceMappingURL=resource.js.map

package/dist/resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.js","sourceRoot":"","sources":["../src/resource.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EACL,aAAa,EACb,YAAY,EAMb,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAGL,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,EACZ,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,WAAW,EAKZ,MAAM,YAAY,CAAC;AAUpB,MAAM,YAAY,GAAoB,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC;AA8GhE,8EAA8E;AAC9E,6CAA6C;AAC7C,8EAA8E;AAE9E,SAAS,OAAO,CAAC,IAAY;IAC3B,OAAO,IAAI;SACR,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,EAAU,EAAE,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;SACxF,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AACvB,CAAC;AAED,SAAS,SAAS,CAAC,IAAY;IAC7B,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;IACpF,IACE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QAClB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QAClB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QAClB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QACnB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EACnB,CAAC;QACD,OAAO,IAAI,GAAG,IAAI,CAAC;IACrB,CAAC;IACD,OAAO,IAAI,GAAG,GAAG,CAAC;AACpB,CAAC;AAED,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E,0EAA0E;AAC1E,SAAS,UAAU,CAAC,MAAc;IAChC,0EAA0E;IAC1E,6DAA6D;IAC7D,MAAM,QAAQ,GAAG,kBAAkB,CAAC,MAAM,CAAa,CAAC;IACxD,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,UAAU,EAAE,kBAAkB,CAAC,MAAM,CAAC;KACvC,CAAC;AACJ,CAAC;AAED,yEAAyE;AACzE,SAAS,eAAe,CAAC,MAAc;IACrC,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,kBAAkB,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;KACpD,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAS,UAAU,CACjB,EAAa,EACb,SAA4B,EAC5B,SAAoD;IAEpD,MAAM,MAAM,GAAG,SAAS,CAAC,EAAE,CAAC,EAAE,MAAM,IAAI,SAAS,CAAC;IAClD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,OAAO,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;AAC9C,CAAC;AAED,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,QAAQ,CACtB,IAAY,EACZ,MAAS,EACT,UAAqC,EAAE;IAEvC,MAAM,cAAc,GAClB,OAAO,CAAC,IAAI,IAAI,IAAI,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;IACjD,MAAM,QAAQ,GAAG,GAAG,cAAc,MAAM,CAAC;IAEzC,MAAM,SAAS,GAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,IAAI,EAAE,CAAC;IAChE,MAAM,MAAM,GAA8C,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC;IACtF,MAAM,UAAU,GACd,OAAO,CAAC,UAAU,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAEtE,MAAM,KAAK,GACR,OAAO,CAAC,KAA6C;QACrD,WAAW,EAA6E,CAAC;IAE5F,MAAM,OAAO,GAAoB,OAAO,CAAC,MAAM,IAAI,YAAY,CAAC;IAEhE,0BAA0B;IAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAEjC,4EAA4E;IAC5E,eAAe;IACf,4EAA4E;IAE5E,MAAM,OAAO,GAAY;QACvB,IAAI,EAAE,GAAG,KAAK,QAAQ;QACtB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,QAAQ,IAAI,UAAU;QACnC,MAAM,EAAE;YACN,KAAK,EAAE;gBACL,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE;gBAC1D,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC1B,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aACzB;SACF;QACD,GAAG,UAAU,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC;QACxC,OAAO,EAAE,KAAK,EAAE,GAAuB,EAAE,EAAE;YACzC,MAAM,CAAC,GAAG,GAAG,CAAC,KAAgC,CAAC;YAC/C,yEAAyE;YACzE,MAAM,KAAK,GAAwB;gBACjC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAClE,GAAG,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACnE,GAAG,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC9D,CAAC;YACF,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;KACF,CAAC;IAEF,MAAM,MAAM,GAAY;QACtB,IAAI,EAAE,GAAG,KAAK,OAAO;QACrB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,gBAAgB,IAAI,QAAQ;QACzC,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE;QAC9D,GAAG,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC;QACvC,OAAO,EAAE,KAAK,EAAE,GAAuB,EAAE,EAAE;YACzC,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC5B,IAAI,CAAC,EAAE;gBAAE,MAAM,IAAI,aAAa,CAAC,GAAG,EAAE,YAAY,EAAE,uBAAuB,CAAC,CAAC;YAC7E,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACnC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBACpB,MAAM,IAAI,aAAa,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,GAAG,IAAI,KAAK,EAAE,cAAc,CAAC,CAAC;YAChG,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAC;IAEF,MAAM,SAAS,GAAY;QACzB,IAAI,EAAE,GAAG,KAAK,UAAU;QACxB,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,YAAY,IAAI,EAAE;QAC/B,MAAM,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,EAAE;QACpC,GAAG,UAAU,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC;QAC1C,OAAO,EAAE,KAAK,EAAE,GAAuB,EAAE,EAAE;YACzC,MAAM,IAAI,GAAG,GAAG,CAAC,OAAmB,CAAC;YACrC,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACxC,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,EAAE,MAAM,CAAC,CAAC;YAC/C,OAAO,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACnC,CAAC;KACF,CAAC;IAEF,MAAM,SAAS,GAAY;QACzB,IAAI,EAAE,GAAG,KAAK,UAAU;QACxB,MAAM,EAAE,OAAO;QACf,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,sBAAsB,IAAI,EAAE;QACzC,MAAM,EAAE;YACN,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;YAClD,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC;SAC9B;QACD,GAAG,UAAU,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC;QAC1C,OAAO,EAAE,KAAK,EAAE,GAAuB,EAAE,EAAE;YACzC,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC5B,IAAI,CAAC,EAAE;gBAAE,MAAM,IAAI,aAAa,CAAC,GAAG,EAAE,YAAY,EAAE,uBAAuB,CAAC,CAAC;YAC7E,MAAM,KAAK,GAAG,GAAG,CAAC,OAA4B,CAAC;YAC/C,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;YAC7C,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBACpB,MAAM,IAAI,aAAa,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,GAAG,IAAI,KAAK,EAAE,cAAc,CAAC,CAAC;YAChG,CAAC;YACD,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,EAAE,MAAM,CAAC,CAAC;YAC/C,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAC;IAEF,MAAM,SAAS,GAAY;QACzB,IAAI,EAAE,GAAG,KAAK,UAAU;QACxB,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,YAAY,IAAI,EAAE;QAC/B,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE;QAC9D,GAAG,UAAU,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC;QAC1C,OAAO,EAAE,KAAK,EAAE,GAAuB,EAAE,EAAE;YACzC,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC5B,IAAI,CAAC,EAAE;gBAAE,MAAM,IAAI,aAAa,CAAC,GAAG,EAAE,YAAY,EAAE,uBAAuB,CAAC,CAAC;YAC7E,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACvC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,aAAa,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,GAAG,IAAI,KAAK,EAAE,cAAc,CAAC,CAAC;YAChG,CAAC;YACD,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;YAC/C,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;KACF,CAAC;IAEF,MAAM,QAAQ,GAA+B;QAC3C,IAAI,EAAE,OAAO;QACb,GAAG,EAAE,MAAM;QACX,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,SAAS;KAClB,CAAC;IAEF,4EAA4E;IAC5E,yBAAyB;IACzB,4EAA4E;IAE5E,MAAM,IAAI,GAAgB;QACxB,IAAI;QACJ,IAAI,EAAE,cAAc;QACpB,MAAM;QACN,KAAK;QAEL,qBAAqB;QACrB,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QACxC,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;YAChB,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC9B,IAAI,CAAC,KAAK,IAAI;gBAAE,MAAM,IAAI,aAAa,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,GAAG,IAAI,KAAK,EAAE,cAAc,CAAC,CAAC;YAC9G,OAAO,CAAC,CAAC;QACX,CAAC;QACD,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACrB,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACxC,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,EAAE,MAAM,CAAC,CAAC;YAC/C,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE;YAC1B,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;YACxC,IAAI,CAAC,KAAK,IAAI;gBAAE,MAAM,IAAI,aAAa,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,GAAG,IAAI,KAAK,EAAE,cAAc,CAAC,CAAC;YAC9G,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,EAAE,CAAC,CAAC,CAAC;YAC1C,OAAO,CAAC,CAAC;QACX,CAAC;QACD,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;YACnB,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACvC,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,aAAa,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,GAAG,IAAI,KAAK,EAAE,cAAc,CAAC,CAAC;YAC5G,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QACjD,CAAC;QAED,IAAI;YACF,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;QAC9C,CAAC;QAED,MAAM;YACJ,OAAO;gBACL,IAAI,EAAE,GAAG,KAAK,GAAG;gBACjB,WAAW,EAAE,mBAAmB,IAAI,EAAE;gBACtC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAe;gBAC9B,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE;gBAC/B,QAAQ,EAAE,IAAI;aACf,CAAC;QACJ,CAAC;QAED,QAAQ;YACN,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;YACvC,MAAM,YAAY,GAA0B;gBAC1C,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;gBAC9C,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACjD,IAAI,EAAE,SAAS;oBACf,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI;oBACnB,QAAQ,EAAE,CAAC,CAAC,QAAQ;iBACrB,CAAC,CAAC;gBACH,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;gBACrD,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;aACtD,CAAC;YACF,OAAO;gBACL,KAAK,EAAE,IAAI;gBACX,IAAI,EAAE,cAAc;gBACpB,MAAM,EAAE,CAAC,IAAI,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,WAAW,CAAC;gBAChE,YAAY;gBACZ,UAAU,EAAE,UAAU;gBACtB,MAAM;gBACN,MAAM,EAAE,UAAU;qBACf,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,MAAM,IAAI,EAAE,KAAK,KAAK,CAAC;qBAC7C,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,KAAK,IAAI,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;gBACnG,KAAK,EAAE,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ;aACzD,CAAC;QACJ,CAAC;KACF,CAAC;IAEF,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/store.d.ts

@@ -0,0 +1,68 @@
+/**
+ * @nexo-alpha/data — storage interface + in-memory implementation.
+ *
+ * `ResourceStore<T>` is the only surface that changes when swapping databases.
+ * `memoryStore()` ships as the default; Drizzle/Prisma/SQLite adapters will
+ * implement the same interface and can derive table definitions from `fields`.
+ */
+/**
+ * Flat query params for list operations.
+ *
+ * Wire format on the HTTP layer:
+ *   `GET /users?sort=name:asc&limit=20&cursor=<opaque>&where[role]=admin`
+ */
+export interface ListQuery<T> {
+    /** Equality filter — every supplied key must match the stored value. */
+    readonly where?: Partial<T>;
+    /**
+     * `"fieldName:asc"` or `"fieldName:desc"`. The field must be a key of `T`.
+     * The store is free to ignore an unrecognised field and fall back to
+     * insertion order.
+     */
+    readonly sort?: string;
+    /** Maximum items to return. Default / max enforced by the store. */
+    readonly limit?: number;
+    /** Opaque continuation token returned by a previous call. */
+    readonly cursor?: string;
+}
+/** A page of results returned by `ResourceStore.list`. */
+export interface Page<E> {
+    readonly items: readonly E[];
+    /** Present when there are more results to fetch. Pass to the next call. */
+    readonly nextCursor?: string;
+}
+/** Every persisted record has `id`, `createdAt`, and `updatedAt` added. */
+export type Entity<T> = T & {
+    readonly id: string;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+};
+/**
+ * The minimal persistence contract that resource handlers depend on.
+ * Swap out the implementation per database without touching a single handler.
+ */
+export interface ResourceStore<T> {
+    list(query: ListQuery<T>): Promise<Page<Entity<T>>>;
+    get(id: string): Promise<Entity<T> | null>;
+    create(data: T): Promise<Entity<T>>;
+    update(id: string, patch: Partial<T>): Promise<Entity<T> | null>;
+    delete(id: string): Promise<boolean>;
+}
+/**
+ * Creates a fully in-memory `ResourceStore<T>`.
+ *
+ * - IDs are time-ordered 26-char strings (ULID-style, no external dep).
+ * - `list()` supports equality `where` filter, `sort`, `limit`, and
+ *   cursor-based pagination.
+ * - Insertion order is preserved when no `sort` is specified.
+ * - All returned objects are deep-cloned, so mutations never affect the store.
+ *
+ * @example
+ * ```ts
+ * const store = memoryStore<User>();
+ * const user = await store.create({ name: "Ada", email: "ada@example.com" });
+ * const page = await store.list({ where: { name: "Ada" }, limit: 10 });
+ * ```
+ */
+export declare function memoryStore<T extends Record<string, unknown>>(): ResourceStore<T>;
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH;;;;;GAKG;AACH,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,wEAAwE;IACxE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,oEAAoE;IACpE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,0DAA0D;AAC1D,MAAM,WAAW,IAAI,CAAC,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;IAC7B,2EAA2E;IAC3E,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAMD,2EAA2E;AAC3E,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,CAAC;AAMF;;;GAGG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC3C,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACpC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACjE,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACtC;AAqCD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,aAAa,CAAC,CAAC,CAAC,CAyFjF"}

package/dist/store.js

@@ -0,0 +1,132 @@
+/**
+ * @nexo-alpha/data — storage interface + in-memory implementation.
+ *
+ * `ResourceStore<T>` is the only surface that changes when swapping databases.
+ * `memoryStore()` ships as the default; Drizzle/Prisma/SQLite adapters will
+ * implement the same interface and can derive table definitions from `fields`.
+ */
+// ---------------------------------------------------------------------------
+// ULID-like ID generation (no external dependency)
+// ---------------------------------------------------------------------------
+// Crockford Base-32 alphabet — no ambiguous characters.
+const B32 = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
+/**
+ * Generates a time-ordered, URL-safe, 26-character ID in the same spirit as
+ * ULID — monotonically increasing within a millisecond, lexicographically
+ * sortable, no external dependency required.
+ */
+function generateId() {
+    const ts = Date.now();
+    // 10 chars for timestamp (48-bit ms epoch in base-32)
+    let tsPart = "";
+    let t = ts;
+    for (let i = 0; i < 10; i++) {
+        tsPart = (B32[t % 32] ?? "0") + tsPart;
+        t = Math.floor(t / 32);
+    }
+    // 16 chars of random
+    let randPart = "";
+    for (let i = 0; i < 16; i++) {
+        randPart += B32[Math.floor(Math.random() * 32)] ?? "0";
+    }
+    return tsPart + randPart;
+}
+// ---------------------------------------------------------------------------
+// In-memory implementation
+// ---------------------------------------------------------------------------
+const DEFAULT_PAGE_SIZE = 50;
+/**
+ * Creates a fully in-memory `ResourceStore<T>`.
+ *
+ * - IDs are time-ordered 26-char strings (ULID-style, no external dep).
+ * - `list()` supports equality `where` filter, `sort`, `limit`, and
+ *   cursor-based pagination.
+ * - Insertion order is preserved when no `sort` is specified.
+ * - All returned objects are deep-cloned, so mutations never affect the store.
+ *
+ * @example
+ * ```ts
+ * const store = memoryStore<User>();
+ * const user = await store.create({ name: "Ada", email: "ada@example.com" });
+ * const page = await store.list({ where: { name: "Ada" }, limit: 10 });
+ * ```
+ */
+export function memoryStore() {
+    // Ordered map: id → entity
+    const rows = new Map();
+    function clone(value) {
+        return JSON.parse(JSON.stringify(value));
+    }
+    return {
+        async list(query) {
+            let items = [...rows.values()];
+            // --- filter ---
+            if (query.where !== undefined) {
+                const where = query.where;
+                items = items.filter((item) => Object.entries(where).every(([k, v]) => v === undefined || item[k] === v));
+            }
+            // --- sort ---
+            if (query.sort !== undefined) {
+                const colonIdx = query.sort.lastIndexOf(":");
+                const field = colonIdx !== -1 ? query.sort.slice(0, colonIdx) : query.sort;
+                const dir = colonIdx !== -1 ? query.sort.slice(colonIdx + 1) : "asc";
+                const asc = dir !== "desc";
+                items = [...items].sort((a, b) => {
+                    const av = a[field];
+                    const bv = b[field];
+                    if (av === bv)
+                        return 0;
+                    if (av === undefined || av === null)
+                        return 1;
+                    if (bv === undefined || bv === null)
+                        return -1;
+                    const as_ = typeof av === "string" ? av : JSON.stringify(av);
+                    const bs_ = typeof bv === "string" ? bv : JSON.stringify(bv);
+                    return (as_ < bs_ ? -1 : as_ > bs_ ? 1 : 0) * (asc ? 1 : -1);
+                });
+            }
+            // --- cursor pagination ---
+            const limit = Math.min(query.limit ?? DEFAULT_PAGE_SIZE, DEFAULT_PAGE_SIZE);
+            let startIdx = 0;
+            if (query.cursor !== undefined) {
+                const cursorIdx = items.findIndex((item) => item.id === query.cursor);
+                if (cursorIdx !== -1)
+                    startIdx = cursorIdx + 1;
+            }
+            const page = items.slice(startIdx, startIdx + limit);
+            const nextCursor = startIdx + limit < items.length ? items[startIdx + limit - 1]?.id : undefined;
+            return {
+                items: page.map(clone),
+                ...(nextCursor !== undefined ? { nextCursor } : {})
+            };
+        },
+        async get(id) {
+            const row = rows.get(id);
+            return row !== undefined ? clone(row) : null;
+        },
+        async create(data) {
+            const now = new Date().toISOString();
+            const entity = { ...clone(data), id: generateId(), createdAt: now, updatedAt: now };
+            rows.set(entity.id, entity);
+            return clone(entity);
+        },
+        async update(id, patch) {
+            const existing = rows.get(id);
+            if (existing === undefined)
+                return null;
+            const updated = {
+                ...existing,
+                ...clone(patch),
+                id: existing.id,
+                createdAt: existing.createdAt,
+                updatedAt: new Date().toISOString()
+            };
+            rows.set(id, updated);
+            return clone(updated);
+        },
+        async delete(id) {
+            return rows.delete(id);
+        }
+    };
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA6DH,8EAA8E;AAC9E,mDAAmD;AACnD,8EAA8E;AAE9E,wDAAwD;AACxD,MAAM,GAAG,GAAG,kCAAkC,CAAC;AAE/C;;;;GAIG;AACH,SAAS,UAAU;IACjB,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACtB,sDAAsD;IACtD,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,CAAC,GAAG,EAAE,CAAC;IACX,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,GAAG,CAAC,GAAG,MAAM,CAAC;QACvC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IACzB,CAAC;IACD,qBAAqB;IACrB,IAAI,QAAQ,GAAG,EAAE,CAAC;IAClB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,QAAQ,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC;IACzD,CAAC;IACD,OAAO,MAAM,GAAG,QAAQ,CAAC;AAC3B,CAAC;AAED,8EAA8E;AAC9E,2BAA2B;AAC3B,8EAA8E;AAE9E,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAE7B;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,WAAW;IACzB,2BAA2B;IAC3B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAqB,CAAC;IAE1C,SAAS,KAAK,CAAI,KAAQ;QACxB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAM,CAAC;IAChD,CAAC;IAED,OAAO;QACL,KAAK,CAAC,IAAI,CAAC,KAAmB;YAC5B,IAAI,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YAE/B,iBAAiB;YACjB,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBAC9B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;gBAC1B,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAC3B,MAAM,CAAC,OAAO,CAAC,KAAK,CAAyB,CAAC,KAAK,CAClD,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,IAAK,IAAgC,CAAC,CAAC,CAAC,KAAK,CAAC,CAC1E,CACF,CAAC;YACJ,CAAC;YAED,eAAe;YACf,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC7B,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;gBAC7C,MAAM,KAAK,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;gBAC3E,MAAM,GAAG,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;gBACrE,MAAM,GAAG,GAAG,GAAG,KAAK,MAAM,CAAC;gBAC3B,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;oBAC/B,MAAM,EAAE,GAAa,CAA6B,CAAC,KAAK,CAAC,CAAC;oBAC1D,MAAM,EAAE,GAAa,CAA6B,CAAC,KAAK,CAAC,CAAC;oBAC1D,IAAI,EAAE,KAAK,EAAE;wBAAE,OAAO,CAAC,CAAC;oBACxB,IAAI,EAAE,KAAK,SAAS,IAAI,EAAE,KAAK,IAAI;wBAAE,OAAO,CAAC,CAAC;oBAC9C,IAAI,EAAE,KAAK,SAAS,IAAI,EAAE,KAAK,IAAI;wBAAE,OAAO,CAAC,CAAC,CAAC;oBAC/C,MAAM,GAAG,GAAG,OAAO,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;oBAC7D,MAAM,GAAG,GAAG,OAAO,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;oBAC7D,OAAO,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC/D,CAAC,CAAC,CAAC;YACL,CAAC;YAED,4BAA4B;YAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,iBAAiB,EAAE,iBAAiB,CAAC,CAAC;YAE5E,IAAI,QAAQ,GAAG,CAAC,CAAC;YACjB,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC/B,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,KAAK,CAAC,MAAM,CAAC,CAAC;gBACtE,IAAI,SAAS,KAAK,CAAC,CAAC;oBAAE,QAAQ,GAAG,SAAS,GAAG,CAAC,CAAC;YACjD,CAAC;YAED,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,GAAG,KAAK,CAAC,CAAC;YACrD,MAAM,UAAU,GACd,QAAQ,GAAG,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,GAAG,KAAK,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;YAEhF,OAAO;gBACL,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;gBACtB,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACpD,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,GAAG,CAAC,EAAU;YAClB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACzB,OAAO,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC/C,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,IAAO;YAClB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YACrC,MAAM,MAAM,GAAc,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;YAC/F,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;YAC5B,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,KAAiB;YACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC9B,IAAI,QAAQ,KAAK,SAAS;gBAAE,OAAO,IAAI,CAAC;YACxC,MAAM,OAAO,GAAc;gBACzB,GAAG,QAAQ;gBACX,GAAG,KAAK,CAAC,KAAK,CAAC;gBACf,EAAE,EAAE,QAAQ,CAAC,EAAE;gBACf,SAAS,EAAE,QAAQ,CAAC,SAAS;gBAC7B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC;YACF,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;YACtB,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,EAAU;YACrB,OAAO,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACzB,CAAC;KACF,CAAC;AACJ,CAAC"}