@lucern/contracts 0.1.2-alpha.4 → 0.3.0-alpha.0

package/dist/defineFunction-DO97DKs4.d.ts

@@ -0,0 +1,14 @@
+import { ZodRawShape, z, ZodObject } from 'zod';
+
+type FunctionEffect = "read" | "write" | "admin";
+type FunctionContract<A extends ZodRawShape = ZodRawShape, R extends z.ZodTypeAny = z.ZodTypeAny> = {
+    name: string;
+    args: ZodObject<A>;
+    returns: R;
+    effects: readonly FunctionEffect[];
+    idempotent?: boolean;
+    invariants?: readonly string[];
+};
+declare function defineFunction<A extends ZodRawShape, R extends z.ZodTypeAny>(spec: FunctionContract<A, R>): FunctionContract<A, R>;
+
+export { type FunctionEffect as F, type FunctionContract as a, defineFunction as d };

package/dist/defineTable-CBQ03FXl.d.ts

@@ -0,0 +1,36 @@
+import { ZodRawShape, ZodObject } from 'zod';
+
+type TableComponent = "mc" | "kernel" | "identity" | "developer-pack";
+type TableIndex = {
+    kind: "index";
+    name: string;
+    columns: readonly string[];
+} | {
+    kind: "search";
+    name: string;
+    searchField: string;
+    filterFields?: readonly string[];
+} | {
+    kind: "vector";
+    name: string;
+    vectorField: string;
+    dimensions: number;
+    filterFields?: readonly string[];
+};
+type TableDeprecation = {
+    since: string;
+    reason: string;
+    replacement?: string;
+};
+type TableContract<S extends ZodRawShape = ZodRawShape> = {
+    name: string;
+    component: TableComponent;
+    category: string;
+    shape: ZodObject<S>;
+    indices: readonly TableIndex[];
+    deprecated?: TableDeprecation;
+    invariants?: readonly string[];
+};
+declare function defineTable<S extends ZodRawShape>(spec: TableContract<S>): TableContract<S>;
+
+export { type TableContract as T, type TableIndex as a, type TableComponent as b, type TableDeprecation as c, defineTable as d };

package/dist/dsl-BgpoVOVQ.d.ts

@@ -0,0 +1,110 @@
+import { a as FunctionContract, F as FunctionEffect, d as defineFunction } from './defineFunction-DO97DKs4.js';
+import { a as TableIndex, b as TableComponent, T as TableContract, c as TableDeprecation, d as defineTable } from './defineTable-CBQ03FXl.js';
+import { a as CONVEX_ID_TABLE, C as ConvexIdSchema, g as getConvexIdTable, i as idOf } from './idOf-DR8tkhQS.js';
+import { z, ZodTypeAny } from 'zod';
+
+type AdapterKind = "convex" | "jsonschema" | "cli";
+type AdapterPurpose = "table" | "function_args" | "function_returns";
+type AdapterContext = {
+    adapter: AdapterKind;
+    purpose?: AdapterPurpose;
+    location?: string;
+    path?: readonly string[];
+};
+declare class SchemaAdapterError extends Error {
+    readonly context: AdapterContext;
+    constructor(message: string, context: AdapterContext);
+}
+declare function schemaAdapterError(message: string, context: AdapterContext): SchemaAdapterError;
+
+type CliOptionKind = "string" | "number" | "bigint" | "boolean" | "json";
+type CliOptionSpec = {
+    name: string;
+    kind: CliOptionKind;
+    required: boolean;
+    variadic?: boolean;
+    nullable?: boolean;
+    choices?: readonly (string | number | boolean)[];
+    defaultValue?: unknown;
+    description?: string;
+};
+type CliCommandSpec = {
+    options: readonly CliOptionSpec[];
+};
+type ZodToCliOptions = {
+    location?: string;
+};
+declare function zodToCli(schema: z.ZodObject<z.ZodRawShape>, options?: ZodToCliOptions): CliCommandSpec;
+
+type ConvexDefault = {
+    path: readonly string[];
+    value: unknown;
+};
+type ZodToConvexOptions = {
+    purpose?: AdapterPurpose;
+    location?: string;
+};
+type ZodToConvexResult = {
+    source: string;
+    defaults: readonly ConvexDefault[];
+};
+declare function zodToConvex(schema: ZodTypeAny, options?: ZodToConvexOptions): ZodToConvexResult;
+declare function tableIndexToConvexSource(index: TableIndex): string;
+
+type JsonSchema = boolean | {
+    $schema?: string;
+    type?: string | readonly string[];
+    properties?: Record<string, JsonSchema>;
+    required?: readonly string[];
+    additionalProperties?: boolean | JsonSchema;
+    items?: JsonSchema;
+    enum?: readonly (string | number | boolean)[];
+    const?: string | number | boolean | null;
+    anyOf?: readonly JsonSchema[];
+    oneOf?: readonly JsonSchema[];
+    default?: unknown;
+    format?: string;
+    description?: string;
+    [key: string]: unknown;
+};
+type ZodToJsonSchemaOptions = {
+    location?: string;
+};
+declare function zodToJsonSchema(schema: ZodTypeAny, options?: ZodToJsonSchemaOptions): JsonSchema;
+
+type dsl_AdapterContext = AdapterContext;
+type dsl_AdapterKind = AdapterKind;
+type dsl_AdapterPurpose = AdapterPurpose;
+declare const dsl_CONVEX_ID_TABLE: typeof CONVEX_ID_TABLE;
+type dsl_CliCommandSpec = CliCommandSpec;
+type dsl_CliOptionKind = CliOptionKind;
+type dsl_CliOptionSpec = CliOptionSpec;
+type dsl_ConvexDefault = ConvexDefault;
+declare const dsl_ConvexIdSchema: typeof ConvexIdSchema;
+declare const dsl_FunctionContract: typeof FunctionContract;
+declare const dsl_FunctionEffect: typeof FunctionEffect;
+type dsl_JsonSchema = JsonSchema;
+type dsl_SchemaAdapterError = SchemaAdapterError;
+declare const dsl_SchemaAdapterError: typeof SchemaAdapterError;
+declare const dsl_TableComponent: typeof TableComponent;
+declare const dsl_TableContract: typeof TableContract;
+declare const dsl_TableDeprecation: typeof TableDeprecation;
+declare const dsl_TableIndex: typeof TableIndex;
+type dsl_ZodToCliOptions = ZodToCliOptions;
+type dsl_ZodToConvexOptions = ZodToConvexOptions;
+type dsl_ZodToConvexResult = ZodToConvexResult;
+type dsl_ZodToJsonSchemaOptions = ZodToJsonSchemaOptions;
+declare const dsl_defineFunction: typeof defineFunction;
+declare const dsl_defineTable: typeof defineTable;
+declare const dsl_getConvexIdTable: typeof getConvexIdTable;
+declare const dsl_idOf: typeof idOf;
+declare const dsl_schemaAdapterError: typeof schemaAdapterError;
+declare const dsl_tableIndexToConvexSource: typeof tableIndexToConvexSource;
+declare const dsl_zodToCli: typeof zodToCli;
+declare const dsl_zodToConvex: typeof zodToConvex;
+declare const dsl_zodToJsonSchema: typeof zodToJsonSchema;
+declare namespace dsl {
+  export { type dsl_AdapterContext as AdapterContext, type dsl_AdapterKind as AdapterKind, type dsl_AdapterPurpose as AdapterPurpose, dsl_CONVEX_ID_TABLE as CONVEX_ID_TABLE, type dsl_CliCommandSpec as CliCommandSpec, type dsl_CliOptionKind as CliOptionKind, type dsl_CliOptionSpec as CliOptionSpec, type dsl_ConvexDefault as ConvexDefault, dsl_ConvexIdSchema as ConvexIdSchema, dsl_FunctionContract as FunctionContract, dsl_FunctionEffect as FunctionEffect, type dsl_JsonSchema as JsonSchema, dsl_SchemaAdapterError as SchemaAdapterError, dsl_TableComponent as TableComponent, dsl_TableContract as TableContract, dsl_TableDeprecation as TableDeprecation, dsl_TableIndex as TableIndex, type dsl_ZodToCliOptions as ZodToCliOptions, type dsl_ZodToConvexOptions as ZodToConvexOptions, type dsl_ZodToConvexResult as ZodToConvexResult, type dsl_ZodToJsonSchemaOptions as ZodToJsonSchemaOptions, dsl_defineFunction as defineFunction, dsl_defineTable as defineTable, dsl_getConvexIdTable as getConvexIdTable, dsl_idOf as idOf, dsl_schemaAdapterError as schemaAdapterError, dsl_tableIndexToConvexSource as tableIndexToConvexSource, dsl_zodToCli as zodToCli, dsl_zodToConvex as zodToConvex, dsl_zodToJsonSchema as zodToJsonSchema };
+}
+
+export { type AdapterKind as A, type CliOptionKind as C, type JsonSchema as J, SchemaAdapterError as S, type ZodToCliOptions as Z, type AdapterPurpose as a, type AdapterContext as b, type CliOptionSpec as c, dsl as d, type CliCommandSpec as e, type ConvexDefault as f, type ZodToConvexOptions as g, type ZodToConvexResult as h, zodToConvex as i, type ZodToJsonSchemaOptions as j, zodToJsonSchema as k, schemaAdapterError as s, tableIndexToConvexSource as t, zodToCli as z };

package/dist/dsl.d.ts

@@ -0,0 +1,5 @@
+export { a as FunctionContract, F as FunctionEffect, d as defineFunction } from './defineFunction-DO97DKs4.js';
+export { b as TableComponent, T as TableContract, c as TableDeprecation, a as TableIndex, d as defineTable } from './defineTable-CBQ03FXl.js';
+export { b as AdapterContext, A as AdapterKind, a as AdapterPurpose, e as CliCommandSpec, C as CliOptionKind, c as CliOptionSpec, f as ConvexDefault, J as JsonSchema, S as SchemaAdapterError, Z as ZodToCliOptions, g as ZodToConvexOptions, h as ZodToConvexResult, j as ZodToJsonSchemaOptions, s as schemaAdapterError, t as tableIndexToConvexSource, z as zodToCli, i as zodToConvex, k as zodToJsonSchema } from './dsl-BgpoVOVQ.js';
+export { a as CONVEX_ID_TABLE, C as ConvexIdSchema, g as getConvexIdTable, i as idOf } from './idOf-DR8tkhQS.js';
+import 'zod';