@basictech/schema 0.7.0 → 0.11.0-beta.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Basic
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission 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

@@ -1,6 +1,8 @@
 # Basic Schema Library
 
-A TypeScript library for validating and managing Basic schemas and their data.
+A TypeScript library for validating Basic schemas and inferring SDK record types. The package root
+contains runtime validation; the dependency-light `@basictech/schema/define` subpath contains the
+typed helpers and is the preferred app-schema import.
 
 ## Installation
 
@@ -14,6 +16,24 @@ npm install @basictech/schema
 import { validateSchema, validateData, generateEmptySchema, validateUpdateSchema } from '@basictech/schema'
 ```
 
+For a typed 0.11 client schema:
+
+```typescript
+import { defineSchema, type InferRecord } from '@basictech/schema/define'
+
+export const schema = defineSchema({
+  project_id: 'my-project',
+  version: 1,
+  tables: {
+    todos: { fields: { title: { type: 'string', required: true } } },
+  },
+})
+
+type Todo = InferRecord<typeof schema, 'todos'>
+```
+
+`@basictech/core` re-exports these helpers and adds `InferValue` (the value without `id`).
+
 ## API Reference
 
 ### `validateSchema(schema: any)`
@@ -171,4 +191,4 @@ if (dataValidation.valid) {
 
 ## License
 
-MIT
+MIT

package/dist/define.d.mts

@@ -0,0 +1,43 @@
+type BasicFieldType = 'string' | 'boolean' | 'number' | 'json';
+interface BasicFieldDef {
+    type: BasicFieldType;
+    indexed?: boolean;
+    required?: boolean;
+}
+interface BasicTableDef {
+    name?: string;
+    type?: 'collection';
+    origin?: {
+        type: 'reference';
+        project_id: string;
+        table: string;
+        version?: number;
+    };
+    fields: Record<string, BasicFieldDef>;
+}
+interface BasicSchema {
+    project_id: string;
+    namespace?: string;
+    version: number;
+    tables: Record<string, BasicTableDef>;
+}
+/** Preserve schema literals for table and record type inference. */
+declare function defineSchema<const S extends BasicSchema>(schema: S): S;
+type FieldValue<F extends BasicFieldDef> = F['type'] extends 'string' ? string : F['type'] extends 'number' ? number : F['type'] extends 'boolean' ? boolean : F['type'] extends 'json' ? unknown : never;
+type RequiredFieldNames<T extends BasicTableDef> = {
+    [K in keyof T['fields']]: T['fields'][K] extends {
+        required: true;
+    } ? K : never;
+}[keyof T['fields']];
+type OptionalFieldNames<T extends BasicTableDef> = Exclude<keyof T['fields'], RequiredFieldNames<T>>;
+/** The record shape for a schema table, including its Basic record id. */
+type InferRecord<S extends BasicSchema, T extends keyof S['tables']> = {
+    id: string;
+} & {
+    [K in RequiredFieldNames<S['tables'][T]>]: FieldValue<S['tables'][T]['fields'][K]>;
+} & {
+    [K in OptionalFieldNames<S['tables'][T]>]?: FieldValue<S['tables'][T]['fields'][K]>;
+};
+type TableNames<S extends BasicSchema> = keyof S['tables'] & string;
+
+export { type BasicFieldDef, type BasicFieldType, type BasicSchema, type BasicTableDef, type InferRecord, type TableNames, defineSchema };

package/dist/define.d.ts

@@ -0,0 +1,43 @@
+type BasicFieldType = 'string' | 'boolean' | 'number' | 'json';
+interface BasicFieldDef {
+    type: BasicFieldType;
+    indexed?: boolean;
+    required?: boolean;
+}
+interface BasicTableDef {
+    name?: string;
+    type?: 'collection';
+    origin?: {
+        type: 'reference';
+        project_id: string;
+        table: string;
+        version?: number;
+    };
+    fields: Record<string, BasicFieldDef>;
+}
+interface BasicSchema {
+    project_id: string;
+    namespace?: string;
+    version: number;
+    tables: Record<string, BasicTableDef>;
+}
+/** Preserve schema literals for table and record type inference. */
+declare function defineSchema<const S extends BasicSchema>(schema: S): S;
+type FieldValue<F extends BasicFieldDef> = F['type'] extends 'string' ? string : F['type'] extends 'number' ? number : F['type'] extends 'boolean' ? boolean : F['type'] extends 'json' ? unknown : never;
+type RequiredFieldNames<T extends BasicTableDef> = {
+    [K in keyof T['fields']]: T['fields'][K] extends {
+        required: true;
+    } ? K : never;
+}[keyof T['fields']];
+type OptionalFieldNames<T extends BasicTableDef> = Exclude<keyof T['fields'], RequiredFieldNames<T>>;
+/** The record shape for a schema table, including its Basic record id. */
+type InferRecord<S extends BasicSchema, T extends keyof S['tables']> = {
+    id: string;
+} & {
+    [K in RequiredFieldNames<S['tables'][T]>]: FieldValue<S['tables'][T]['fields'][K]>;
+} & {
+    [K in OptionalFieldNames<S['tables'][T]>]?: FieldValue<S['tables'][T]['fields'][K]>;
+};
+type TableNames<S extends BasicSchema> = keyof S['tables'] & string;
+
+export { type BasicFieldDef, type BasicFieldType, type BasicSchema, type BasicTableDef, type InferRecord, type TableNames, defineSchema };

package/dist/define.js

@@ -0,0 +1,33 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// define.ts
+var define_exports = {};
+__export(define_exports, {
+  defineSchema: () => defineSchema
+});
+module.exports = __toCommonJS(define_exports);
+function defineSchema(schema) {
+  return schema;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  defineSchema
+});
+//# sourceMappingURL=define.js.map

package/dist/define.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../define.ts"],"sourcesContent":["export type BasicFieldType = 'string' | 'boolean' | 'number' | 'json'\n\nexport interface BasicFieldDef {\n  type: BasicFieldType\n  indexed?: boolean\n  required?: boolean\n}\n\nexport interface BasicTableDef {\n  name?: string\n  type?: 'collection'\n  origin?: {\n    type: 'reference'\n    project_id: string\n    table: string\n    version?: number\n  }\n  fields: Record<string, BasicFieldDef>\n}\n\nexport interface BasicSchema {\n  project_id: string\n  namespace?: string\n  version: number\n  tables: Record<string, BasicTableDef>\n}\n\n/** Preserve schema literals for table and record type inference. */\nexport function defineSchema<const S extends BasicSchema>(schema: S): S {\n  return schema\n}\n\ntype FieldValue<F extends BasicFieldDef> =\n  F['type'] extends 'string' ? string\n    : F['type'] extends 'number' ? number\n      : F['type'] extends 'boolean' ? boolean\n        : F['type'] extends 'json' ? unknown\n          : never\n\ntype RequiredFieldNames<T extends BasicTableDef> = {\n  [K in keyof T['fields']]: T['fields'][K] extends { required: true } ? K : never\n}[keyof T['fields']]\n\ntype OptionalFieldNames<T extends BasicTableDef> = Exclude<keyof T['fields'], RequiredFieldNames<T>>\n\n/** The record shape for a schema table, including its Basic record id. */\nexport type InferRecord<S extends BasicSchema, T extends keyof S['tables']> =\n  { id: string }\n  & { [K in RequiredFieldNames<S['tables'][T]>]: FieldValue<S['tables'][T]['fields'][K]> }\n  & { [K in OptionalFieldNames<S['tables'][T]>]?: FieldValue<S['tables'][T]['fields'][K]> }\n\nexport type TableNames<S extends BasicSchema> = keyof S['tables'] & string\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AA4BO,SAAS,aAA0C,QAAc;AACtE,SAAO;AACT;","names":[]}

package/dist/define.mjs

@@ -0,0 +1,8 @@
+// define.ts
+function defineSchema(schema) {
+  return schema;
+}
+export {
+  defineSchema
+};
+//# sourceMappingURL=define.mjs.map

package/dist/define.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../define.ts"],"sourcesContent":["export type BasicFieldType = 'string' | 'boolean' | 'number' | 'json'\n\nexport interface BasicFieldDef {\n  type: BasicFieldType\n  indexed?: boolean\n  required?: boolean\n}\n\nexport interface BasicTableDef {\n  name?: string\n  type?: 'collection'\n  origin?: {\n    type: 'reference'\n    project_id: string\n    table: string\n    version?: number\n  }\n  fields: Record<string, BasicFieldDef>\n}\n\nexport interface BasicSchema {\n  project_id: string\n  namespace?: string\n  version: number\n  tables: Record<string, BasicTableDef>\n}\n\n/** Preserve schema literals for table and record type inference. */\nexport function defineSchema<const S extends BasicSchema>(schema: S): S {\n  return schema\n}\n\ntype FieldValue<F extends BasicFieldDef> =\n  F['type'] extends 'string' ? string\n    : F['type'] extends 'number' ? number\n      : F['type'] extends 'boolean' ? boolean\n        : F['type'] extends 'json' ? unknown\n          : never\n\ntype RequiredFieldNames<T extends BasicTableDef> = {\n  [K in keyof T['fields']]: T['fields'][K] extends { required: true } ? K : never\n}[keyof T['fields']]\n\ntype OptionalFieldNames<T extends BasicTableDef> = Exclude<keyof T['fields'], RequiredFieldNames<T>>\n\n/** The record shape for a schema table, including its Basic record id. */\nexport type InferRecord<S extends BasicSchema, T extends keyof S['tables']> =\n  { id: string }\n  & { [K in RequiredFieldNames<S['tables'][T]>]: FieldValue<S['tables'][T]['fields'][K]> }\n  & { [K in OptionalFieldNames<S['tables'][T]>]?: FieldValue<S['tables'][T]['fields'][K]> }\n\nexport type TableNames<S extends BasicSchema> = keyof S['tables'] & string\n"],"mappings":";AA4BO,SAAS,aAA0C,QAAc;AACtE,SAAO;AACT;","names":[]}

package/package.json

@@ -1,7 +1,13 @@
 {
   "name": "@basictech/schema",
-  "version": "0.7.0",
+  "version": "0.11.0-beta.2",
+  "private": false,
   "description": "utils for Basic Schema",
+  "license": "MIT",
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "type": "commonjs",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
@@ -15,32 +21,40 @@
         "types": "./dist/index.d.ts",
         "default": "./dist/index.js"
       }
+    },
+    "./define": {
+      "import": {
+        "types": "./dist/define.d.mts",
+        "default": "./dist/define.mjs"
+      },
+      "require": {
+        "types": "./dist/define.d.ts",
+        "default": "./dist/define.js"
+      }
     }
   },
   "files": [
     "dist"
   ],
-  "sideEffects": false,
-  "private": false,
-  "publishConfig": {
-    "access": "public"
-  },
   "scripts": {
     "prebuild": "node scripts/generate-validator.js",
     "build": "tsup",
     "dev": "tsup --watch",
+    "prepack": "npm run build",
     "test": "vitest run",
     "test:watch": "vitest",
     "generate-validator": "node scripts/generate-validator.js"
   },
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false,
   "author": "",
-  "license": "ISC",
   "dependencies": {
     "ajv": "^8.17.1",
     "ajv-errors": "^3.0.0"
   },
   "devDependencies": {
-    "@repo/typescript-config": "*",
     "tsup": "^8.0.0",
     "typescript": "^5.0.0",
     "vitest": "^1.6.0"