@purveyors/sdk 0.0.0 → 0.2.0

package/dist/index.js

@@ -0,0 +1,54 @@
+// src/client.ts
+import createClient from "openapi-fetch";
+function createParchmentClient(options) {
+  const { baseUrl, token, fetch: fetchImpl } = options;
+  const client = createClient({
+    baseUrl,
+    fetch: fetchImpl,
+    headers: token ? { Authorization: `Bearer ${token}` } : void 0
+  });
+  return {
+    /** The underlying typed openapi-fetch client for direct path access. */
+    raw: client,
+    /** Liveness and service identity. */
+    health: () => client.GET("/health"),
+    /** Resolved principal and entitlements for the caller. */
+    me: () => client.GET("/v1/me"),
+    catalog: {
+      /** Catalog capabilities and visibility for the caller. */
+      access: () => client.GET("/v1/catalog/access"),
+      /** List public catalog coffees (paginated). */
+      list: (query) => client.GET("/v1/catalog", { params: { query } }),
+      /** Aggregate proof-coverage over the public catalog. */
+      proofCoverage: () => client.GET("/v1/catalog/proof-coverage"),
+      /** Find catalog coffees similar to a target coffee. */
+      similar: (id, query) => client.GET("/v1/catalog/{id}/similar", {
+        params: { path: { id }, query }
+      })
+    },
+    priceIndex: {
+      /** Parchment Price Index (aggregate snapshots). */
+      list: (query) => client.GET("/v1/price-index", { params: { query } })
+    },
+    procurement: {
+      briefs: {
+        /** List the caller's saved sourcing briefs. */
+        list: () => client.GET("/v1/procurement/briefs"),
+        /** Create a saved sourcing brief. */
+        create: (body) => client.POST("/v1/procurement/briefs", { body }),
+        /** Fetch one of the caller's sourcing briefs by id. */
+        get: (id) => client.GET("/v1/procurement/briefs/{id}", {
+          params: { path: { id } }
+        }),
+        /** Run a saved brief against the catalog (paginated matches). */
+        matches: (id, query) => client.GET("/v1/procurement/briefs/{id}/matches", {
+          params: { path: { id }, query }
+        })
+      }
+    }
+  };
+}
+export {
+  createParchmentClient
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts"],"sourcesContent":["import createClient, { type ClientOptions } from \"openapi-fetch\";\nimport type { components, paths } from \"./schema\";\n\nexport interface ParchmentClientOptions {\n  /** Base URL of the Parchment API, e.g. https://api.purveyors.io */\n  baseUrl: string;\n  /**\n   * Optional bearer token (a Supabase JWT or, later, an API key). Sent as\n   * `Authorization: Bearer <token>`. Auth is resolved server-side against the\n   * unified principal model; the SDK only forwards the credential.\n   */\n  token?: string;\n  /** Override the fetch implementation (useful for tests or custom runtimes). */\n  fetch?: ClientOptions[\"fetch\"];\n}\n\n/** Query parameters for {@link ParchmentClient.catalog.list}. */\nexport type CatalogListQuery = NonNullable<\n  paths[\"/v1/catalog\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/** Query parameters for {@link ParchmentClient.catalog.similar}. */\nexport type CatalogSimilarQuery = NonNullable<\n  paths[\"/v1/catalog/{id}/similar\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/** Query parameters for {@link ParchmentClient.priceIndex.list}. */\nexport type PriceIndexQuery = NonNullable<\n  paths[\"/v1/price-index\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/** Query parameters for {@link ParchmentClient.procurement.briefs.matches}. */\nexport type BriefMatchesQuery = NonNullable<\n  paths[\"/v1/procurement/briefs/{id}/matches\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/** Request body for {@link ParchmentClient.procurement.briefs.create}. */\nexport type SourcingBriefCreateRequest =\n  components[\"schemas\"][\"SourcingBriefCreateRequest\"];\n\n/**\n * Create a typed Parchment API client.\n *\n * The generated core (openapi-fetch over the generated `paths` types) is the\n * contract truth; the named helpers below are the hand-maintained ergonomic\n * layer and grow as endpoints land. `raw` always exposes the underlying typed\n * client for direct path access to anything not yet wrapped.\n */\nexport function createParchmentClient(options: ParchmentClientOptions) {\n  const { baseUrl, token, fetch: fetchImpl } = options;\n\n  const client = createClient<paths>({\n    baseUrl,\n    fetch: fetchImpl,\n    headers: token ? { Authorization: `Bearer ${token}` } : undefined,\n  });\n\n  return {\n    /** The underlying typed openapi-fetch client for direct path access. */\n    raw: client,\n    /** Liveness and service identity. */\n    health: () => client.GET(\"/health\"),\n    /** Resolved principal and entitlements for the caller. */\n    me: () => client.GET(\"/v1/me\"),\n    catalog: {\n      /** Catalog capabilities and visibility for the caller. */\n      access: () => client.GET(\"/v1/catalog/access\"),\n      /** List public catalog coffees (paginated). */\n      list: (query?: CatalogListQuery) =>\n        client.GET(\"/v1/catalog\", { params: { query } }),\n      /** Aggregate proof-coverage over the public catalog. */\n      proofCoverage: () => client.GET(\"/v1/catalog/proof-coverage\"),\n      /** Find catalog coffees similar to a target coffee. */\n      similar: (id: string, query?: CatalogSimilarQuery) =>\n        client.GET(\"/v1/catalog/{id}/similar\", {\n          params: { path: { id }, query },\n        }),\n    },\n    priceIndex: {\n      /** Parchment Price Index (aggregate snapshots). */\n      list: (query?: PriceIndexQuery) =>\n        client.GET(\"/v1/price-index\", { params: { query } }),\n    },\n    procurement: {\n      briefs: {\n        /** List the caller's saved sourcing briefs. */\n        list: () => client.GET(\"/v1/procurement/briefs\"),\n        /** Create a saved sourcing brief. */\n        create: (body: SourcingBriefCreateRequest) =>\n          client.POST(\"/v1/procurement/briefs\", { body }),\n        /** Fetch one of the caller's sourcing briefs by id. */\n        get: (id: string) =>\n          client.GET(\"/v1/procurement/briefs/{id}\", {\n            params: { path: { id } },\n          }),\n        /** Run a saved brief against the catalog (paginated matches). */\n        matches: (id: string, query?: BriefMatchesQuery) =>\n          client.GET(\"/v1/procurement/briefs/{id}/matches\", {\n            params: { path: { id }, query },\n          }),\n      },\n    },\n  };\n}\n\nexport type ParchmentClient = ReturnType<typeof createParchmentClient>;\n"],"mappings":";AAAA,OAAO,kBAA0C;AA4C1C,SAAS,sBAAsB,SAAiC;AACrE,QAAM,EAAE,SAAS,OAAO,OAAO,UAAU,IAAI;AAE7C,QAAM,SAAS,aAAoB;AAAA,IACjC;AAAA,IACA,OAAO;AAAA,IACP,SAAS,QAAQ,EAAE,eAAe,UAAU,KAAK,GAAG,IAAI;AAAA,EAC1D,CAAC;AAED,SAAO;AAAA;AAAA,IAEL,KAAK;AAAA;AAAA,IAEL,QAAQ,MAAM,OAAO,IAAI,SAAS;AAAA;AAAA,IAElC,IAAI,MAAM,OAAO,IAAI,QAAQ;AAAA,IAC7B,SAAS;AAAA;AAAA,MAEP,QAAQ,MAAM,OAAO,IAAI,oBAAoB;AAAA;AAAA,MAE7C,MAAM,CAAC,UACL,OAAO,IAAI,eAAe,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AAAA;AAAA,MAEjD,eAAe,MAAM,OAAO,IAAI,4BAA4B;AAAA;AAAA,MAE5D,SAAS,CAAC,IAAY,UACpB,OAAO,IAAI,4BAA4B;AAAA,QACrC,QAAQ,EAAE,MAAM,EAAE,GAAG,GAAG,MAAM;AAAA,MAChC,CAAC;AAAA,IACL;AAAA,IACA,YAAY;AAAA;AAAA,MAEV,MAAM,CAAC,UACL,OAAO,IAAI,mBAAmB,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AAAA,IACvD;AAAA,IACA,aAAa;AAAA,MACX,QAAQ;AAAA;AAAA,QAEN,MAAM,MAAM,OAAO,IAAI,wBAAwB;AAAA;AAAA,QAE/C,QAAQ,CAAC,SACP,OAAO,KAAK,0BAA0B,EAAE,KAAK,CAAC;AAAA;AAAA,QAEhD,KAAK,CAAC,OACJ,OAAO,IAAI,+BAA+B;AAAA,UACxC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE;AAAA,QACzB,CAAC;AAAA;AAAA,QAEH,SAAS,CAAC,IAAY,UACpB,OAAO,IAAI,uCAAuC;AAAA,UAChD,QAAQ,EAAE,MAAM,EAAE,GAAG,GAAG,MAAM;AAAA,QAChC,CAAC;AAAA,MACL;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@purveyors/sdk",
-  "version": "0.0.0",
+  "version": "0.2.0",
   "description": "Typed client for the Purveyors Parchment API, generated from its OpenAPI spec.",
   "license": "MIT",
   "type": "module",