@sequenceholdings/orm 2.1.0 → 2.2.0

package/dist/compiler.d.cts

@@ -3,8 +3,11 @@ import { ClaimKey, PredIr, RootIr, InputRefKind, TableMetaIr, CompiledOperation,
 import { DocumentNode, OperationDefinitionNode, FragmentDefinitionNode, GraphQLSchema, ValueNode, SelectionSetNode } from 'graphql';
 export { DynamicInputIssue, DynamicInputResult, NormalizedBoolExp, NormalizedOnConflict, NormalizedOrderBy, NormalizedRow, ORDER_BY_DIRECTIONS, ScalarKind, allowedBoolExpOperators, allowedOps, validateAppendInput, validateBoolExpInput, validateInsertInput, validateOnConflictInput, validateOrderByInput, validateSelectColumns, validateSetInput } from './dynamic-input.cjs';
 export { CompilePolicyInput, CompilePredicateInput, POLICY_COMPARE_OPS, POLICY_MAX_LINK_DEPTH, ParsedPolicy, PolicyColumnInfo, PolicyCompareOp, PolicyCompileError, PolicyCompileErrorCode, PolicyLinkInfo, PolicyNode, PolicyOperand, PolicyParseError, PolicyResolver, PolicyTableInfo, assertClaimsOnlyWhen, compilePolicy, compilePredicateV2, parsePolicy, walkPolicy } from './predicate-v2.cjs';
-export { P as PLATFORM_USER_TYPENAME, c as camelCase, e as enumTypeName, p as pascalCase } from './naming-DPglwzkB.cjs';
-import 'zod';
+import { z } from 'zod';
+export { P as PLATFORM_USER_TYPENAME, c as camelCase, g as enumTypeName, p as pascalCase } from './naming-CU9ThP_E.cjs';
+export { S as SqlOperationDefinition, d as defineOperation, s as sqlOperationDefinitionSchema } from './definition-DjfC7Lll.cjs';
+import './constants-C6EG6Wq7.cjs';
+import './policy-1iZbGnZZ.cjs';
 
 type DiagnosticSeverity = 'error' | 'warning';
 interface CompilerDiagnostic {
@@ -157,9 +160,16 @@ interface CowMutationRootInfo {
     /** Override: properties copied INSERT…SELECT from synced (pk included). */
     copyColumns: readonly string[];
 }
-type MutationRootInfo = CrudMutationRootInfo | CowMutationRootInfo;
+/** A resolved-table write root (the table is the resolved view). */
+interface ResolvedMutationRootInfo {
+    op: 'resolvedWrite';
+    action: 'insert' | 'update' | 'delete' | 'revert';
+    table: string;
+}
+type MutationRootInfo = CrudMutationRootInfo | CowMutationRootInfo | ResolvedMutationRootInfo;
 interface CompileContext {
     namespace: string;
+    composed: boolean;
     tables: Record<string, TableMetaIr>;
     /** GraphQL object type name → table name. */
     tableByTypename: Map<string, string>;
@@ -329,6 +339,7 @@ declare class OperationLowerer {
     private readonly variables;
     constructor(ctx: CompileContext, restricted: RestrictedOperation);
     private meta;
+    /** A data column — cell-metadata columns are reachable only through `cells { … }`. */
     private column;
     private link;
     private fieldCandidates;
@@ -347,6 +358,12 @@ declare class OperationLowerer {
     private lowerLimit;
     private lowerOffset;
     lowerSelection(selectionSet: SelectionSetNode, table: string): SelectionIr;
+    /**
+     * `cells { <column> { at by … } }` — typed per-cell metadata. Plain tables
+     * offer `at`/`by`; resolved tables add the winning `source` and newer
+     * `conflicts { source at value }`.
+     */
+    private lowerCells;
     /** The `{ aggregate { count sum {…} avg {…} } nodes {…} }` block shared by roots and relations. */
     private lowerAggregateSelection;
     /**
@@ -394,6 +411,12 @@ declare class OperationLowerer {
      * the structured fields, never from authored statements.
      */
     private lowerCowRoot;
+    /**
+     * Resolved-table roots: insertOne(object), updateByPk(pkColumns, _set),
+     * deleteByPk(pk…), revertByPk(pkColumns, columns). The executor writes only
+     * the touched cells into the manual source; `returning` reads the view.
+     */
+    private lowerResolvedRoot;
     private lowerMutationResponse;
     private lowerInsertObjects;
     private lowerInsertRow;
@@ -418,4 +441,56 @@ declare function predContainsExists(pred: PredIr): boolean;
 /** Structural containment: does `haystack` carry `needle` as a subtree? */
 declare function predContains(haystack: PredIr, needle: PredIr): boolean;
 
-export { type BuildContextResult, COMPILER_MAJOR, CONST_TRUE, type ClientManifest, type ClientManifestOperation, type CompileContext, type CompileNamespaceInput, type CompileNamespaceResult, type CompilerDiagnostic, DEFAULT_LIMIT, type DiagnosticSeverity, DocumentCompileError, MAX_LIMIT, type MutationOp, type MutationRootInfo, NamespaceCompileError, OperationLowerer, PLATFORM_USER_TABLE, type ParseDocumentsResult, type ParsedDocument, type PinnedColumn, type QueryRootInfo, type RestrictedOperation, type SourceDocument, andPred, buildCompileContext, canonicalOperationText, classifyInputType, collectPinnedColumns, compileNamespace, compileNamespaceOrThrow, computeOpHash, computeOpsHash, computePinnedColumnsByTable, computeSchemaHash, flattenOperation, injectPolicies, inputTypeName, lowerOperation, mutationRootNames, parseDocuments, parseSdl, platformUserMeta, predContains, predContainsExists, queryRootNames, restrictOperation, typeNameForTable, walkPred };
+declare function isSqlOperationDocument(path: string, contents?: string): boolean;
+/** Additive language dispatch. GraphQL still uses its original compiler/hash. */
+declare function compileOperationDocuments(input: CompileNamespaceInput): Promise<CompileNamespaceResult>;
+
+/** This is deliberately not an arbitrary JSON variable: types and size are bounded. */
+declare const sqlQueryInputSchema: z.ZodObject<{
+    sql: z.ZodString;
+    parameters: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+        value: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"uuid">;
+        value: z.ZodNullable<z.ZodGUID>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"date">;
+        value: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"timestamptz">;
+        value: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"numeric">;
+        value: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"bigint">;
+        value: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"integer">;
+        value: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"double">;
+        value: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"boolean">;
+        value: z.ZodNullable<z.ZodBoolean>;
+    }, z.core.$strict>], "type">>>;
+}, z.core.$strict>;
+type SqlQueryInput = z.infer<typeof sqlQueryInputSchema>;
+/** The returned plan contains no bound parameter values or caller identity. */
+declare function compileRuntimeSql({ operation, input }: {
+    operation: CompiledOperation;
+    input: SqlQueryInput;
+}): Promise<CompiledOperation>;
+
+declare const DATASET_PREVIEW_LIMIT = 100;
+/**
+ * Fixed runtime-owned reads, separate from the published operation manifest.
+ * Use logical column identities directly (no GraphQL naming conversion) and
+ * the normal compiler context/policy pass. Like generated GraphQL, internal
+ * source tables, raw synced backings, and cell metadata are not exposed.
+ */
+declare function compileDatasetPreviews(input: CanonicalDefinition): Record<string, CompiledOperation>;
+
+export { type BuildContextResult, COMPILER_MAJOR, CONST_TRUE, type ClientManifest, type ClientManifestOperation, type CompileContext, type CompileNamespaceInput, type CompileNamespaceResult, type CompilerDiagnostic, DATASET_PREVIEW_LIMIT, DEFAULT_LIMIT, type DiagnosticSeverity, DocumentCompileError, MAX_LIMIT, type MutationOp, type MutationRootInfo, NamespaceCompileError, OperationLowerer, PLATFORM_USER_TABLE, type ParseDocumentsResult, type ParsedDocument, type PinnedColumn, type QueryRootInfo, type RestrictedOperation, type SourceDocument, type SqlQueryInput, andPred, buildCompileContext, canonicalOperationText, classifyInputType, collectPinnedColumns, compileDatasetPreviews, compileNamespace, compileNamespaceOrThrow, compileOperationDocuments, compileRuntimeSql, computeOpHash, computeOpsHash, computePinnedColumnsByTable, computeSchemaHash, flattenOperation, injectPolicies, inputTypeName, isSqlOperationDocument, lowerOperation, mutationRootNames, parseDocuments, parseSdl, platformUserMeta, predContains, predContainsExists, queryRootNames, restrictOperation, sqlQueryInputSchema, typeNameForTable, walkPred };

package/dist/compiler.d.ts

@@ -3,8 +3,11 @@ import { ClaimKey, PredIr, RootIr, InputRefKind, TableMetaIr, CompiledOperation,
 import { DocumentNode, OperationDefinitionNode, FragmentDefinitionNode, GraphQLSchema, ValueNode, SelectionSetNode } from 'graphql';
 export { DynamicInputIssue, DynamicInputResult, NormalizedBoolExp, NormalizedOnConflict, NormalizedOrderBy, NormalizedRow, ORDER_BY_DIRECTIONS, ScalarKind, allowedBoolExpOperators, allowedOps, validateAppendInput, validateBoolExpInput, validateInsertInput, validateOnConflictInput, validateOrderByInput, validateSelectColumns, validateSetInput } from './dynamic-input.js';
 export { CompilePolicyInput, CompilePredicateInput, POLICY_COMPARE_OPS, POLICY_MAX_LINK_DEPTH, ParsedPolicy, PolicyColumnInfo, PolicyCompareOp, PolicyCompileError, PolicyCompileErrorCode, PolicyLinkInfo, PolicyNode, PolicyOperand, PolicyParseError, PolicyResolver, PolicyTableInfo, assertClaimsOnlyWhen, compilePolicy, compilePredicateV2, parsePolicy, walkPolicy } from './predicate-v2.js';
-export { P as PLATFORM_USER_TYPENAME, c as camelCase, e as enumTypeName, p as pascalCase } from './naming-DCn94LJ4.js';
-import 'zod';
+import { z } from 'zod';
+export { P as PLATFORM_USER_TYPENAME, c as camelCase, g as enumTypeName, p as pascalCase } from './naming-CPfx7EfF.js';
+export { S as SqlOperationDefinition, d as defineOperation, s as sqlOperationDefinitionSchema } from './definition-DjfC7Lll.js';
+import './constants-C6EG6Wq7.js';
+import './policy-1iZbGnZZ.js';
 
 type DiagnosticSeverity = 'error' | 'warning';
 interface CompilerDiagnostic {
@@ -157,9 +160,16 @@ interface CowMutationRootInfo {
     /** Override: properties copied INSERT…SELECT from synced (pk included). */
     copyColumns: readonly string[];
 }
-type MutationRootInfo = CrudMutationRootInfo | CowMutationRootInfo;
+/** A resolved-table write root (the table is the resolved view). */
+interface ResolvedMutationRootInfo {
+    op: 'resolvedWrite';
+    action: 'insert' | 'update' | 'delete' | 'revert';
+    table: string;
+}
+type MutationRootInfo = CrudMutationRootInfo | CowMutationRootInfo | ResolvedMutationRootInfo;
 interface CompileContext {
     namespace: string;
+    composed: boolean;
     tables: Record<string, TableMetaIr>;
     /** GraphQL object type name → table name. */
     tableByTypename: Map<string, string>;
@@ -329,6 +339,7 @@ declare class OperationLowerer {
     private readonly variables;
     constructor(ctx: CompileContext, restricted: RestrictedOperation);
     private meta;
+    /** A data column — cell-metadata columns are reachable only through `cells { … }`. */
     private column;
     private link;
     private fieldCandidates;
@@ -347,6 +358,12 @@ declare class OperationLowerer {
     private lowerLimit;
     private lowerOffset;
     lowerSelection(selectionSet: SelectionSetNode, table: string): SelectionIr;
+    /**
+     * `cells { <column> { at by … } }` — typed per-cell metadata. Plain tables
+     * offer `at`/`by`; resolved tables add the winning `source` and newer
+     * `conflicts { source at value }`.
+     */
+    private lowerCells;
     /** The `{ aggregate { count sum {…} avg {…} } nodes {…} }` block shared by roots and relations. */
     private lowerAggregateSelection;
     /**
@@ -394,6 +411,12 @@ declare class OperationLowerer {
      * the structured fields, never from authored statements.
      */
     private lowerCowRoot;
+    /**
+     * Resolved-table roots: insertOne(object), updateByPk(pkColumns, _set),
+     * deleteByPk(pk…), revertByPk(pkColumns, columns). The executor writes only
+     * the touched cells into the manual source; `returning` reads the view.
+     */
+    private lowerResolvedRoot;
     private lowerMutationResponse;
     private lowerInsertObjects;
     private lowerInsertRow;
@@ -418,4 +441,56 @@ declare function predContainsExists(pred: PredIr): boolean;
 /** Structural containment: does `haystack` carry `needle` as a subtree? */
 declare function predContains(haystack: PredIr, needle: PredIr): boolean;
 
-export { type BuildContextResult, COMPILER_MAJOR, CONST_TRUE, type ClientManifest, type ClientManifestOperation, type CompileContext, type CompileNamespaceInput, type CompileNamespaceResult, type CompilerDiagnostic, DEFAULT_LIMIT, type DiagnosticSeverity, DocumentCompileError, MAX_LIMIT, type MutationOp, type MutationRootInfo, NamespaceCompileError, OperationLowerer, PLATFORM_USER_TABLE, type ParseDocumentsResult, type ParsedDocument, type PinnedColumn, type QueryRootInfo, type RestrictedOperation, type SourceDocument, andPred, buildCompileContext, canonicalOperationText, classifyInputType, collectPinnedColumns, compileNamespace, compileNamespaceOrThrow, computeOpHash, computeOpsHash, computePinnedColumnsByTable, computeSchemaHash, flattenOperation, injectPolicies, inputTypeName, lowerOperation, mutationRootNames, parseDocuments, parseSdl, platformUserMeta, predContains, predContainsExists, queryRootNames, restrictOperation, typeNameForTable, walkPred };
+declare function isSqlOperationDocument(path: string, contents?: string): boolean;
+/** Additive language dispatch. GraphQL still uses its original compiler/hash. */
+declare function compileOperationDocuments(input: CompileNamespaceInput): Promise<CompileNamespaceResult>;
+
+/** This is deliberately not an arbitrary JSON variable: types and size are bounded. */
+declare const sqlQueryInputSchema: z.ZodObject<{
+    sql: z.ZodString;
+    parameters: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+        value: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"uuid">;
+        value: z.ZodNullable<z.ZodGUID>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"date">;
+        value: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"timestamptz">;
+        value: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"numeric">;
+        value: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"bigint">;
+        value: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"integer">;
+        value: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"double">;
+        value: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"boolean">;
+        value: z.ZodNullable<z.ZodBoolean>;
+    }, z.core.$strict>], "type">>>;
+}, z.core.$strict>;
+type SqlQueryInput = z.infer<typeof sqlQueryInputSchema>;
+/** The returned plan contains no bound parameter values or caller identity. */
+declare function compileRuntimeSql({ operation, input }: {
+    operation: CompiledOperation;
+    input: SqlQueryInput;
+}): Promise<CompiledOperation>;
+
+declare const DATASET_PREVIEW_LIMIT = 100;
+/**
+ * Fixed runtime-owned reads, separate from the published operation manifest.
+ * Use logical column identities directly (no GraphQL naming conversion) and
+ * the normal compiler context/policy pass. Like generated GraphQL, internal
+ * source tables, raw synced backings, and cell metadata are not exposed.
+ */
+declare function compileDatasetPreviews(input: CanonicalDefinition): Record<string, CompiledOperation>;
+
+export { type BuildContextResult, COMPILER_MAJOR, CONST_TRUE, type ClientManifest, type ClientManifestOperation, type CompileContext, type CompileNamespaceInput, type CompileNamespaceResult, type CompilerDiagnostic, DATASET_PREVIEW_LIMIT, DEFAULT_LIMIT, type DiagnosticSeverity, DocumentCompileError, MAX_LIMIT, type MutationOp, type MutationRootInfo, NamespaceCompileError, OperationLowerer, PLATFORM_USER_TABLE, type ParseDocumentsResult, type ParsedDocument, type PinnedColumn, type QueryRootInfo, type RestrictedOperation, type SourceDocument, type SqlQueryInput, andPred, buildCompileContext, canonicalOperationText, classifyInputType, collectPinnedColumns, compileDatasetPreviews, compileNamespace, compileNamespaceOrThrow, compileOperationDocuments, compileRuntimeSql, computeOpHash, computeOpsHash, computePinnedColumnsByTable, computeSchemaHash, flattenOperation, injectPolicies, inputTypeName, isSqlOperationDocument, lowerOperation, mutationRootNames, parseDocuments, parseSdl, platformUserMeta, predContains, predContainsExists, queryRootNames, restrictOperation, sqlQueryInputSchema, typeNameForTable, walkPred };