@sf-ai/sdk 0.2.0

package/LICENSE

@@ -0,0 +1,20 @@
+The San Francisco License (SF License)
+
+Copyright (c) San Francisco License Contributors 2026
+
+Permission is granted, free of charge, to any person or organization
+obtaining a copy of this software and associated documentation files
+(the "Software"), to use, copy, modify, merge, publish, distribute,
+sublicense, and/or sell copies of the Software, and to permit others
+to whom the Software is furnished to do the same.
+
+The only requirement is that this license notice and copyright 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/README.md

@@ -0,0 +1,125 @@
+# @sf-ai/sdk
+
+Type-safe SDK for the San Francisco database with GraphQL codegen.
+
+## Overview
+
+This package provides a type-safe SDK generated from the San Francisco RAG database schema using `@constructive-io/graphql-codegen`. It generates both React Query hooks and a Prisma-like ORM client from the PGPM modules.
+
+## Installation
+
+```bash
+pnpm add @sf-ai/sdk
+```
+
+## Usage
+
+### ORM Client
+
+```typescript
+import { createClient } from '@sf-ai/sdk';
+
+const db = createClient({
+  endpoint: process.env.GRAPHQL_ENDPOINT,
+  headers: {
+    Authorization: `Bearer ${process.env.API_TOKEN}`,
+  },
+});
+
+// Query documents
+const documents = await db.document.findMany({
+  select: { id: true, title: true, content: true },
+  first: 10,
+}).execute().unwrap();
+
+// Query chunks with embeddings
+const chunks = await db.chunk.findMany({
+  select: {
+    id: true,
+    content: true,
+    document: { select: { id: true, title: true } },
+  },
+}).execute().unwrap();
+```
+
+### React Query Hooks
+
+```typescript
+import { useDocumentsQuery, useChunksQuery } from '@sf-ai/sdk';
+
+function DocumentList() {
+  const { data, isLoading } = useDocumentsQuery({ first: 10 });
+
+  if (isLoading) return <div>Loading...</div>;
+
+  return (
+    <ul>
+      {data?.documents.nodes.map((doc) => (
+        <li key={doc.id}>{doc.title}</li>
+      ))}
+    </ul>
+  );
+}
+```
+
+## Regenerating the SDK
+
+The SDK is generated from the PGPM modules in this repository. To regenerate:
+
+### Locally
+
+Requires a running PostgreSQL database with the schema deployed:
+
+```bash
+cd packages/sf-sdk
+pnpm run codegen:all
+```
+
+### Via GitHub Actions
+
+Use the "Generate SDK" workflow which:
+
+1. Spins up an ephemeral PostgreSQL database
+2. Deploys the PGPM modules
+3. Generates the SDK types
+4. Optionally commits the changes
+
+Run the workflow from the Actions tab with the "commit_changes" option enabled to automatically commit regenerated types.
+
+## Configuration
+
+The codegen configuration is in `graphql-codegen.config.ts`:
+
+```typescript
+import { defineConfig } from '@constructive-io/graphql-codegen';
+
+export default defineConfig({
+  targets: {
+    default: {
+      db: {
+        pgpm: {
+          modulePath: '../rag-core',
+        },
+        schemas: ['rag'],
+      },
+      output: './src/generated',
+      // ... other options
+    },
+  },
+});
+```
+
+## Schema
+
+The SDK is generated from the `rag` schema which includes:
+
+- `embedding_model` - Embedding model configurations
+- `collection` - Document collections
+- `collection_model` - Collection-model associations
+- `document` - Full documents
+- `chunk` - Document chunks for RAG
+- `embedding` - Vector embeddings
+
+## License
+
+MIT

package/client.d.ts

@@ -0,0 +1,10 @@
+export interface SFClientConfig {
+    endpoint: string;
+    headers?: Record<string, string>;
+}
+export interface SFClient {
+    endpoint: string;
+    headers: Record<string, string>;
+}
+export declare function createClient(config: SFClientConfig): SFClient;
+//# sourceMappingURL=client.d.ts.map

package/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,QAAQ,CAK7D"}

package/client.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createClient = createClient;
+function createClient(config) {
+    return {
+        endpoint: config.endpoint,
+        headers: config.headers || {},
+    };
+}

package/esm/client.d.ts

@@ -0,0 +1,10 @@
+export interface SFClientConfig {
+    endpoint: string;
+    headers?: Record<string, string>;
+}
+export interface SFClient {
+    endpoint: string;
+    headers: Record<string, string>;
+}
+export declare function createClient(config: SFClientConfig): SFClient;
+//# sourceMappingURL=client.d.ts.map

package/esm/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,QAAQ,CAK7D"}

package/esm/client.js

@@ -0,0 +1,6 @@
+export function createClient(config) {
+    return {
+        endpoint: config.endpoint,
+        headers: config.headers || {},
+    };
+}

package/esm/index.d.ts

@@ -0,0 +1,3 @@
+export { createClient } from './client';
+export type { SFClient, SFClientConfig } from './client';
+//# sourceMappingURL=index.d.ts.map

package/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC"}

package/esm/index.js

@@ -0,0 +1 @@
+export { createClient } from './client';

package/index.d.ts

@@ -0,0 +1,3 @@
+export { createClient } from './client';
+export type { SFClient, SFClientConfig } from './client';
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC"}

package/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createClient = void 0;
+var client_1 = require("./client");
+Object.defineProperty(exports, "createClient", { enumerable: true, get: function () { return client_1.createClient; } });

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@sf-ai/sdk",
+  "version": "0.2.0",
+  "description": "Type-safe SDK for the San Francisco database with GraphQL codegen",
+  "author": "City of San Francisco <opensource@sfgov.org>",
+  "license": "MIT",
+  "main": "index.js",
+  "module": "esm/index.js",
+  "types": "index.d.ts",
+  "homepage": "https://github.com/city-of-san-francisco/sf-rag-utils",
+  "publishConfig": {
+    "access": "public",
+    "directory": "dist"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/city-of-san-francisco/sf-rag-utils"
+  },
+  "bugs": {
+    "url": "https://github.com/city-of-san-francisco/sf-rag-utils/issues"
+  },
+  "scripts": {
+    "copy": "makage assets",
+    "clean": "makage clean",
+    "prepublishOnly": "npm run build",
+    "build": "makage build",
+    "lint": "eslint . --fix",
+    "test": "jest --passWithNoTests",
+    "test:watch": "jest --watch",
+    "codegen": "npx @constructive-io/graphql-codegen generate -c graphql-codegen.config.ts",
+    "codegen:orm": "npx @constructive-io/graphql-codegen generate-orm -c graphql-codegen.config.ts",
+    "codegen:all": "npm run codegen && npm run codegen:orm"
+  },
+  "keywords": [
+    "san-francisco",
+    "sdk",
+    "graphql",
+    "codegen",
+    "orm",
+    "postgresql"
+  ],
+  "devDependencies": {
+    "@constructive-io/graphql-codegen": "^3.0.3",
+    "makage": "0.1.9"
+  },
+  "gitHead": "1d766c1022d0be8029c9f7be968ed33050c25e3a"
+}