@mauroandre/weave-sdk 0.0.1

package/dist/index.js

@@ -0,0 +1,189 @@
+import {
+  Column,
+  Owned,
+  Reference,
+  WeaveAuthError,
+  WeaveError,
+  WeaveNotFoundError,
+  WeaveScopeError,
+  WeaveValidationError,
+  array,
+  bool,
+  bpchar,
+  bytea,
+  date,
+  defineConfig,
+  defineEntity,
+  defineScope,
+  errorFor,
+  float4,
+  float8,
+  genProject,
+  int2,
+  int4,
+  int8,
+  interval,
+  irToSource,
+  json,
+  jsonb,
+  numeric,
+  owned,
+  pullEntities,
+  pushEntities,
+  pushScopes,
+  reference,
+  scopeToSource,
+  text,
+  time,
+  timestamp,
+  timestamptz,
+  uuid,
+  varchar
+} from "./chunk-PWTED7ZO.js";
+
+// src/serialize.ts
+function reviveShape(shape, value) {
+  if (!value || typeof value !== "object") return value;
+  const obj = value;
+  for (const [key, node] of Object.entries(shape)) {
+    const v = obj[key];
+    if (node instanceof Column) {
+      if (node.config.pgType.tsLabel === "Date" && typeof v === "string") {
+        obj[key] = new Date(v);
+      }
+    } else if (node instanceof Owned) {
+      if (Array.isArray(v)) v.forEach((x) => reviveShape(node.shape, x));
+      else if (v) reviveShape(node.shape, v);
+    } else if (node instanceof Reference) {
+      if (node.cardinality === "many" && Array.isArray(v)) {
+        v.forEach((x) => reviveShape(node.target.columns, x));
+      } else if (v && typeof v === "object") {
+        reviveShape(node.target.columns, v);
+      }
+    }
+  }
+  if (typeof obj["createdAt"] === "string") obj["createdAt"] = new Date(obj["createdAt"]);
+  if (typeof obj["updatedAt"] === "string") obj["updatedAt"] = new Date(obj["updatedAt"]);
+  return obj;
+}
+
+// src/client.ts
+function createClient(options) {
+  const transport = options.fetch ?? ((req) => globalThis.fetch(req));
+  const base = options.url.replace(/\/$/, "");
+  async function request(method, path, opts = {}) {
+    let url = `${base}${path}`;
+    if (opts.query) {
+      const qs = Object.entries(opts.query).filter((e) => e[1] !== void 0).map(([k, v]) => `${k}=${encodeURIComponent(v)}`).join("&");
+      if (qs) url += `?${qs}`;
+    }
+    const headers = { "x-api-key": options.key };
+    if (options.scope) {
+      headers["x-weave-scope"] = options.scope;
+      if (options.params) headers["x-weave-params"] = JSON.stringify(options.params);
+    }
+    const init = { method, headers };
+    if (opts.body !== void 0) {
+      headers["content-type"] = "application/json";
+      init.body = JSON.stringify(opts.body);
+    }
+    const res = await transport(new Request(url, init));
+    if (res.status === 404 && opts.allowNull) return null;
+    const json2 = res.status === 204 ? null : await res.json().catch(() => null);
+    if (!res.ok) {
+      const m = json2 && typeof json2 === "object" && "error" in json2 ? String(json2.error) : `Weave request failed (${res.status}).`;
+      throw errorFor(res.status, m);
+    }
+    return json2;
+  }
+  const queryFrom = (o) => ({
+    expand: JSON.stringify(o.expand ?? {}),
+    where: JSON.stringify(o.where ?? {}),
+    orderBy: o.orderBy !== void 0 ? JSON.stringify(o.orderBy) : void 0,
+    page: o.page !== void 0 ? String(o.page) : void 0,
+    perPage: o.perPage !== void 0 ? String(o.perPage) : void 0
+  });
+  const client = {};
+  for (const [key, entity] of Object.entries(options.entities)) {
+    const shape = entity.columns;
+    const path = `/api/${entity.name}`;
+    const revive = (o) => reviveShape(shape, o);
+    const list = async (o) => await request("GET", path, { query: queryFrom(o) });
+    client[key] = {
+      async create(input) {
+        return revive(await request("POST", path, { body: input }));
+      },
+      async get(id, o = {}) {
+        const r = await request("GET", `${path}/${encodeURIComponent(id)}`, {
+          query: { expand: JSON.stringify(o.expand ?? {}) },
+          allowNull: true
+        });
+        return r === null ? null : revive(r);
+      },
+      async find(o = {}) {
+        return (await list(o)).docs?.map(revive) ?? [];
+      },
+      async findOne(o = {}) {
+        const d = (await list({ ...o, perPage: 1 })).docs?.[0];
+        return d === void 0 ? null : revive(d);
+      },
+      async paginate(o = {}) {
+        const page = await list(o);
+        return {
+          docs: page.docs?.map(revive) ?? [],
+          docsQuantity: page.docsQuantity,
+          pageQuantity: page.pageQuantity,
+          currentPage: page.currentPage
+        };
+      },
+      async update(id, patch) {
+        return revive(await request("PATCH", `${path}/${encodeURIComponent(id)}`, { body: patch }));
+      },
+      async delete(id) {
+        await request("DELETE", `${path}/${encodeURIComponent(id)}`);
+      }
+    };
+  }
+  client["as"] = (scope, params) => createClient({ ...options, scope, ...params ? { params } : {} });
+  return client;
+}
+export {
+  WeaveAuthError,
+  WeaveError,
+  WeaveNotFoundError,
+  WeaveScopeError,
+  WeaveValidationError,
+  array,
+  bool,
+  bpchar,
+  bytea,
+  createClient,
+  date,
+  defineConfig,
+  defineEntity,
+  defineScope,
+  float4,
+  float8,
+  genProject,
+  int2,
+  int4,
+  int8,
+  interval,
+  irToSource,
+  json,
+  jsonb,
+  numeric,
+  owned,
+  pullEntities,
+  pushEntities,
+  pushScopes,
+  reference,
+  scopeToSource,
+  text,
+  time,
+  timestamp,
+  timestamptz,
+  uuid,
+  varchar
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/serialize.ts","../src/client.ts"],"sourcesContent":["import { Column, Owned, Reference, type ShapeRecord } from \"@mauroandre/weave-core\";\n\n// json → obj: a API devolve datas como string ISO. Aqui revivemos pra `Date`,\n// dirigidos pela FORMA da entidade (mesma ideia do read do engine): colunas de\n// tipo Date, owned aninhado (recursivo), e references expandidas (um nível, via\n// a forma do alvo). Os timestamps managed (createdAt/updatedAt) sempre viram Date.\n//\n// (Write não precisa de tratamento: JSON.stringify já serializa Date → ISO, e a\n// reference vai por `<campo>Id`, que é string.)\nexport function reviveShape(shape: ShapeRecord, value: unknown): unknown {\n  if (!value || typeof value !== \"object\") return value;\n  const obj = value as Record<string, unknown>;\n\n  for (const [key, node] of Object.entries(shape)) {\n    const v = obj[key];\n    if (node instanceof Column) {\n      if (node.config.pgType.tsLabel === \"Date\" && typeof v === \"string\") {\n        obj[key] = new Date(v);\n      }\n    } else if (node instanceof Owned) {\n      if (Array.isArray(v)) v.forEach((x) => reviveShape(node.shape, x));\n      else if (v) reviveShape(node.shape, v);\n    } else if (node instanceof Reference) {\n      // Só age se a reference veio EXPANDIDA (objeto/array); id-form é string, ignora.\n      if (node.cardinality === \"many\" && Array.isArray(v)) {\n        v.forEach((x) => reviveShape(node.target.columns, x));\n      } else if (v && typeof v === \"object\") {\n        reviveShape(node.target.columns, v);\n      }\n    }\n  }\n\n  if (typeof obj[\"createdAt\"] === \"string\") obj[\"createdAt\"] = new Date(obj[\"createdAt\"]);\n  if (typeof obj[\"updatedAt\"] === \"string\") obj[\"updatedAt\"] = new Date(obj[\"updatedAt\"]);\n  return obj;\n}\n","import type {\n  Entity,\n  ShapeRecord,\n  InferEntity,\n  InferInsert,\n  InferRead,\n  ExpandInput,\n  WhereInput,\n  OrderByInput,\n} from \"@mauroandre/weave-core\";\nimport { reviveShape } from \"./serialize.js\";\nimport { errorFor } from \"./errors.js\";\n\n/** Função de transporte: recebe um `Request`, devolve um `Response` (WHATWG fetch).\n *  Aceita retorno síncrono ou Promise (o `app.hono.fetch` pode ser síncrono). */\nexport type FetchLike = (request: Request) => Response | Promise<Response>;\n\nexport interface ClientOptions<S> {\n  /** Base URL do Weave (ex.: `https://weave.minha-loja.com`). */\n  url: string;\n  /** API key (`x-api-key`). */\n  key: string;\n  /** O entities-as-code: `{ nome: defineEntity(...) }`. */\n  entities: S;\n  /** Transporte. Default: `globalThis.fetch`. Nos testes: `app.hono.fetch`. */\n  fetch?: FetchLike;\n  /** @internal — scope ativo (`x-weave-scope`), definido via `weave.as(...)`. */\n  scope?: string;\n  /** @internal — params do scope (`x-weave-params`). */\n  params?: Record<string, unknown>;\n}\n\n/**\n * Opções de leitura, todas **tipadas pela entidade**: `where` (`WhereInput`),\n * `orderBy` (`OrderByInput`), e `expand` (`ExpandInput`) que ainda **dirige o tipo\n * do retorno** (`InferRead<E, X>`). Mesmo idioma do engine e da GUI.\n */\nexport interface FindArgs<E extends Entity<string, ShapeRecord>, X> {\n  where?: WhereInput<E>;\n  orderBy?: OrderByInput<E>;\n  expand?: X & ExpandInput<E>;\n  page?: number;\n  perPage?: number;\n}\n\nexport interface PageResult<T> {\n  docs: T[];\n  docsQuantity: number;\n  pageQuantity: number;\n  currentPage: number;\n}\n\n/**\n * Client tipado de UMA entidade. Os reads se **auto-tipam pelo `expand`** que você\n * passa (`const X`), então `find({ expand: { category: true } })` já devolve o\n * objeto com `category` expandido e tipado — sem escrever nenhum `Infer`.\n */\nexport interface EntityClient<E extends Entity<string, ShapeRecord>> {\n  create(input: InferInsert<E>): Promise<InferEntity<E>>;\n  get<const X = {}>(\n    id: string,\n    opts?: { expand?: X & ExpandInput<E> },\n  ): Promise<InferRead<E, X> | null>;\n  find<const X = {}>(opts?: FindArgs<E, X>): Promise<InferRead<E, X>[]>;\n  findOne<const X = {}>(opts?: FindArgs<E, X>): Promise<InferRead<E, X> | null>;\n  paginate<const X = {}>(opts?: FindArgs<E, X>): Promise<PageResult<InferRead<E, X>>>;\n  update(id: string, patch: Partial<InferInsert<E>>): Promise<InferEntity<E>>;\n  delete(id: string): Promise<void>;\n}\n\n/** O client completo: uma propriedade por entidade do entities + `as` (scope). */\nexport type WeaveClient<S extends Record<string, Entity<string, ShapeRecord>>> = {\n  [K in keyof S]: EntityClient<S[K]>;\n} & {\n  /** Client escopado: toda requisição leva `x-weave-scope` + `x-weave-params`. */\n  as(scope: string, params?: Record<string, unknown>): WeaveClient<S>;\n};\n\ninterface ListResponse {\n  docs?: Record<string, unknown>[];\n  docsQuantity: number;\n  pageQuantity: number;\n  currentPage: number;\n}\n\n// Forma frouxa das opções, usada SÓ na implementação (a interface dá os tipos).\ntype AnyArgs = { where?: unknown; orderBy?: unknown; expand?: unknown; page?: number; perPage?: number };\n\n/**\n * Cria o client tipado a partir do entities-as-code. Casca fina sobre a API HTTP do\n * Weave: monta o request, manda o `x-api-key`, revive `obj↔json` (datas) pela forma\n * da entidade, e serializa o `expand` no param. O `fetch` é injetável — em teste,\n * `app.hono.fetch`.\n */\nexport function createClient<S extends Record<string, Entity<string, ShapeRecord>>>(\n  options: ClientOptions<S>,\n): WeaveClient<S> {\n  const transport: FetchLike = options.fetch ?? ((req) => globalThis.fetch(req));\n  const base = options.url.replace(/\\/$/, \"\");\n\n  async function request(\n    method: string,\n    path: string,\n    opts: { query?: Record<string, string | undefined>; body?: unknown; allowNull?: boolean } = {},\n  ): Promise<unknown> {\n    let url = `${base}${path}`;\n    if (opts.query) {\n      const qs = Object.entries(opts.query)\n        .filter((e): e is [string, string] => e[1] !== undefined)\n        .map(([k, v]) => `${k}=${encodeURIComponent(v)}`)\n        .join(\"&\");\n      if (qs) url += `?${qs}`;\n    }\n\n    const headers: Record<string, string> = { \"x-api-key\": options.key };\n    if (options.scope) {\n      headers[\"x-weave-scope\"] = options.scope;\n      if (options.params) headers[\"x-weave-params\"] = JSON.stringify(options.params);\n    }\n    const init: RequestInit = { method, headers };\n    if (opts.body !== undefined) {\n      headers[\"content-type\"] = \"application/json\";\n      init.body = JSON.stringify(opts.body);\n    }\n\n    const res = await transport(new Request(url, init));\n    if (res.status === 404 && opts.allowNull) return null;\n    const json = res.status === 204 ? null : await res.json().catch(() => null);\n    if (!res.ok) {\n      const m =\n        json && typeof json === \"object\" && \"error\" in json\n          ? String((json as { error: unknown }).error)\n          : `Weave request failed (${res.status}).`;\n      throw errorFor(res.status, m);\n    }\n    return json;\n  }\n\n  // `where` e `expand` vão SEMPRE (default `{}`): `where={}` força o caminho\n  // WhereInput na API e o `expand={}` deixa o tipo de retorno determinístico.\n  const queryFrom = (o: AnyArgs): Record<string, string | undefined> => ({\n    expand: JSON.stringify(o.expand ?? {}),\n    where: JSON.stringify(o.where ?? {}),\n    orderBy: o.orderBy !== undefined ? JSON.stringify(o.orderBy) : undefined,\n    page: o.page !== undefined ? String(o.page) : undefined,\n    perPage: o.perPage !== undefined ? String(o.perPage) : undefined,\n  });\n\n  const client: Record<string, unknown> = {};\n\n  for (const [key, entity] of Object.entries(options.entities)) {\n    const shape = entity.columns;\n    const path = `/api/${entity.name}`;\n    const revive = (o: unknown) => reviveShape(shape, o);\n    const list = async (o: AnyArgs): Promise<ListResponse> =>\n      (await request(\"GET\", path, { query: queryFrom(o) })) as ListResponse;\n\n    client[key] = {\n      async create(input: unknown) {\n        return revive(await request(\"POST\", path, { body: input }));\n      },\n      async get(id: string, o: { expand?: unknown } = {}) {\n        const r = await request(\"GET\", `${path}/${encodeURIComponent(id)}`, {\n          query: { expand: JSON.stringify(o.expand ?? {}) },\n          allowNull: true,\n        });\n        return r === null ? null : revive(r);\n      },\n      async find(o: AnyArgs = {}) {\n        return (await list(o)).docs?.map(revive) ?? [];\n      },\n      async findOne(o: AnyArgs = {}) {\n        const d = (await list({ ...o, perPage: 1 })).docs?.[0];\n        return d === undefined ? null : revive(d);\n      },\n      async paginate(o: AnyArgs = {}) {\n        const page = await list(o);\n        return {\n          docs: page.docs?.map(revive) ?? [],\n          docsQuantity: page.docsQuantity,\n          pageQuantity: page.pageQuantity,\n          currentPage: page.currentPage,\n        };\n      },\n      async update(id: string, patch: unknown) {\n        return revive(await request(\"PATCH\", `${path}/${encodeURIComponent(id)}`, { body: patch }));\n      },\n      async delete(id: string) {\n        await request(\"DELETE\", `${path}/${encodeURIComponent(id)}`);\n      },\n    };\n  }\n\n  // `weave.as(scope, params)` → novo client com os headers de scope em toda req.\n  client[\"as\"] = (scope: string, params?: Record<string, unknown>) =>\n    createClient({ ...options, scope, ...(params ? { params } : {}) });\n\n  return client as unknown as WeaveClient<S>;\n}\n"],"mappings":"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","names":["json"]}

package/dist/scope-DrcCzdf-.d.ts

@@ -0,0 +1,100 @@
+import { Entity, ShapeRecord, InferInsert, InferEntity, ExpandInput, InferRead, WhereInput, OrderByInput } from '@mauroandre/weave-core';
+
+/** Função de transporte: recebe um `Request`, devolve um `Response` (WHATWG fetch).
+ *  Aceita retorno síncrono ou Promise (o `app.hono.fetch` pode ser síncrono). */
+type FetchLike = (request: Request) => Response | Promise<Response>;
+interface ClientOptions<S> {
+    /** Base URL do Weave (ex.: `https://weave.minha-loja.com`). */
+    url: string;
+    /** API key (`x-api-key`). */
+    key: string;
+    /** O entities-as-code: `{ nome: defineEntity(...) }`. */
+    entities: S;
+    /** Transporte. Default: `globalThis.fetch`. Nos testes: `app.hono.fetch`. */
+    fetch?: FetchLike;
+    /** @internal — scope ativo (`x-weave-scope`), definido via `weave.as(...)`. */
+    scope?: string;
+    /** @internal — params do scope (`x-weave-params`). */
+    params?: Record<string, unknown>;
+}
+/**
+ * Opções de leitura, todas **tipadas pela entidade**: `where` (`WhereInput`),
+ * `orderBy` (`OrderByInput`), e `expand` (`ExpandInput`) que ainda **dirige o tipo
+ * do retorno** (`InferRead<E, X>`). Mesmo idioma do engine e da GUI.
+ */
+interface FindArgs<E extends Entity<string, ShapeRecord>, X> {
+    where?: WhereInput<E>;
+    orderBy?: OrderByInput<E>;
+    expand?: X & ExpandInput<E>;
+    page?: number;
+    perPage?: number;
+}
+interface PageResult<T> {
+    docs: T[];
+    docsQuantity: number;
+    pageQuantity: number;
+    currentPage: number;
+}
+/**
+ * Client tipado de UMA entidade. Os reads se **auto-tipam pelo `expand`** que você
+ * passa (`const X`), então `find({ expand: { category: true } })` já devolve o
+ * objeto com `category` expandido e tipado — sem escrever nenhum `Infer`.
+ */
+interface EntityClient<E extends Entity<string, ShapeRecord>> {
+    create(input: InferInsert<E>): Promise<InferEntity<E>>;
+    get<const X = {}>(id: string, opts?: {
+        expand?: X & ExpandInput<E>;
+    }): Promise<InferRead<E, X> | null>;
+    find<const X = {}>(opts?: FindArgs<E, X>): Promise<InferRead<E, X>[]>;
+    findOne<const X = {}>(opts?: FindArgs<E, X>): Promise<InferRead<E, X> | null>;
+    paginate<const X = {}>(opts?: FindArgs<E, X>): Promise<PageResult<InferRead<E, X>>>;
+    update(id: string, patch: Partial<InferInsert<E>>): Promise<InferEntity<E>>;
+    delete(id: string): Promise<void>;
+}
+/** O client completo: uma propriedade por entidade do entities + `as` (scope). */
+type WeaveClient<S extends Record<string, Entity<string, ShapeRecord>>> = {
+    [K in keyof S]: EntityClient<S[K]>;
+} & {
+    /** Client escopado: toda requisição leva `x-weave-scope` + `x-weave-params`. */
+    as(scope: string, params?: Record<string, unknown>): WeaveClient<S>;
+};
+/**
+ * Cria o client tipado a partir do entities-as-code. Casca fina sobre a API HTTP do
+ * Weave: monta o request, manda o `x-api-key`, revive `obj↔json` (datas) pela forma
+ * da entidade, e serializa o `expand` no param. O `fetch` é injetável — em teste,
+ * `app.hono.fetch`.
+ */
+declare function createClient<S extends Record<string, Entity<string, ShapeRecord>>>(options: ClientOptions<S>): WeaveClient<S>;
+
+type Verb = "read" | "create" | "update" | "delete";
+interface ScopeEntityRule {
+    verbs: Verb[];
+    /** Filtro de linhas (WhereInput, por NOME; valores podem ser `{ param: "x" }`). */
+    where?: Record<string, unknown>;
+    /** Projeção: caminhos por NOME (dot-path, ex.: `"items.secret"`). */
+    fields?: {
+        include?: string[];
+        exclude?: string[];
+    };
+}
+interface ScopeDef {
+    name: string;
+    entities: Record<string, ScopeEntityRule>;
+}
+/** Helper tipado pro scope-as-code (igual `defineEntity`). */
+declare function defineScope(name: string, entities: Record<string, ScopeEntityRule>): ScopeDef;
+interface PushScopesOptions {
+    url: string;
+    key: string;
+    fetch?: FetchLike;
+}
+/**
+ * Empurra scopes-as-code: converte cada regra (where + fields por NOME) pro formato
+ * por-id e grava via `PUT /admin/scopes/:name`. Busca os IRs das entidades pra
+ * resolver os ids (rename-proof no storage).
+ */
+declare function pushScopes(scopes: Record<string, ScopeDef>, options: PushScopesOptions): Promise<{
+    pushed: string[];
+}>;
+
+export { type ClientOptions as C, type EntityClient as E, type FetchLike as F, type PageResult as P, type ScopeDef as S, type Verb as V, type WeaveClient as W, type FindArgs as a, type PushScopesOptions as b, type ScopeEntityRule as c, createClient as d, defineScope as e, pushScopes as p };

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@mauroandre/weave-sdk",
+  "version": "0.0.1",
+  "description": "Weave SDK — typed object client over the Weave HTTP API. The glue: entities-as-code in, objects out, HTTP/JSON invisible.",
+  "type": "module",
+  "license": "MIT",
+  "author": "Mauro André",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mauro-andre/weave.git",
+    "directory": "packages/sdk"
+  },
+  "homepage": "https://github.com/mauro-andre/weave#readme",
+  "bugs": "https://github.com/mauro-andre/weave/issues",
+  "bin": {
+    "weave": "dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./cli": {
+      "types": "./dist/cli.d.ts",
+      "import": "./dist/cli.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "weave",
+    "postgres",
+    "orm",
+    "typed-client",
+    "sdk",
+    "typescript"
+  ]
+}