@stardeck-customer-apps/data-store-sdk 0.1.0-preview.5 → 0.1.0

package/SKILL.md

@@ -1,6 +1,18 @@
 # Data Store SDK - AI Agent Skill Guide
 
-This guide helps AI agents understand and implement data store features using `@stardeck-customer-apps/data-store-sdk`.
+This guide documents the **runtime SDK** that the customer's deployed app uses to read and write data store data at request time. It's for code that runs inside the customer's app — API routes, server actions, edge functions.
+
+> **IMPORTANT — agent vs runtime distinction:**
+>
+> If you (the agent) need to create tables, add columns, change column types, or insert/update/delete rows during planning, use your **dedicated data store tools** instead of writing app code that calls this SDK:
+>
+> - `createDataStoreTable`, `addDataStoreColumn`, `renameDataStoreColumn`, `changeDataStoreColumnType`, `deleteDataStoreColumn`, `deleteDataStoreTable` — schema management
+> - `insertDataStoreRow`, `updateDataStoreRow`, `deleteDataStoreRow` — row mutations (use these for seeding data)
+> - `queryDataStore`, `getDataStoreSchema`, `listDataStores` — reads
+>
+> Those tools operate on the same branch the customer's deployed app reads/writes via `DATA_STORE_*_URL`, so they stay in sync.
+>
+> **Only write code that imports `@stardeck-customer-apps/data-store-sdk` when** the customer's app needs to perform data store operations at request time — for example, a CRUD UI, a multi-tenant app that creates per-customer tables on signup, or a background job. Do NOT use the SDK to seed initial data or set up schema during build/planning — use the agent tools above.
 
 ## Quick Reference
 

package/dist/server/index.js

@@ -257,24 +257,9 @@ async function createDataStore(options) {
   const { Kysely: KyselyClass } = await import("kysely");
   const { NeonDialect } = await import("kysely-neon");
   const { neon, types } = await import("@neondatabase/serverless");
-  const customTypes = {
-    ...types,
-    getTypeParser: ((oid, format) => {
-      if (oid === 1700) return (val) => parseFloat(val);
-      return types.getTypeParser(oid, format);
-    })
-  };
-  const baseSql = neon(connectionString);
-  const wrappedSql = {
-    query: (queryWithPlaceholders, params, queryOpts) => (
-      // eslint-disable-next-line @typescript-eslint/no-explicit-any
-      baseSql.query(queryWithPlaceholders, params, {
-        ...queryOpts,
-        types: customTypes
-      })
-    )
-  };
-  const dialect = new NeonDialect({ neon: wrappedSql });
+  types.setTypeParser(1700, (val) => parseFloat(val));
+  const sql = neon(connectionString);
+  const dialect = new NeonDialect({ neon: sql });
   return new KyselyClass({
     dialect,
     ...options?.kyselyConfig

package/dist/server/index.mjs

@@ -206,24 +206,9 @@ async function createDataStore(options) {
   const { Kysely: KyselyClass } = await import("kysely");
   const { NeonDialect } = await import("kysely-neon");
   const { neon, types } = await import("@neondatabase/serverless");
-  const customTypes = {
-    ...types,
-    getTypeParser: ((oid, format) => {
-      if (oid === 1700) return (val) => parseFloat(val);
-      return types.getTypeParser(oid, format);
-    })
-  };
-  const baseSql = neon(connectionString);
-  const wrappedSql = {
-    query: (queryWithPlaceholders, params, queryOpts) => (
-      // eslint-disable-next-line @typescript-eslint/no-explicit-any
-      baseSql.query(queryWithPlaceholders, params, {
-        ...queryOpts,
-        types: customTypes
-      })
-    )
-  };
-  const dialect = new NeonDialect({ neon: wrappedSql });
+  types.setTypeParser(1700, (val) => parseFloat(val));
+  const sql = neon(connectionString);
+  const dialect = new NeonDialect({ neon: sql });
   return new KyselyClass({
     dialect,
     ...options?.kyselyConfig

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stardeck-customer-apps/data-store-sdk",
-  "version": "0.1.0-preview.5",
+  "version": "0.1.0",
   "description": "SDK for accessing Stardeck data stores from deployed projects",
   "main": "dist/index.js",
   "module": "dist/index.mjs",