@quereus/quereus 3.3.0 → 4.0.0

package/dist/src/func/builtins/mutation.js

@@ -0,0 +1,53 @@
+import { createScalarFunction } from '../registration.js';
+import { INTEGER_TYPE } from '../../types/builtin-types.js';
+import { QuereusError } from '../../common/errors.js';
+import { StatusCode } from '../../common/types.js';
+/**
+ * `mutation_ordinal()` — the 1-based ordinal of the row being produced within the
+ * current INSERT / mutation-context evaluation.
+ *
+ * It is the column-`default`-position analogue of `row_number()`: a deterministic
+ * per-row primitive that reaches where a window function cannot (a column default),
+ * so a basis author can compose a high-water-mark surrogate allocator entirely in
+ * SQL — e.g. `default (coalesce((select max(rid) from anchor_tbl), 0) + mutation_ordinal())`
+ * — which reconstructs the old zero-config `integer-auto` surrogate as ordinary
+ * declared-default SQL (docs/view-updateability.md § Mutation Context,
+ * docs/architecture.md § Sequential ID Generation).
+ *
+ * **Deterministic** (it depends only on the captured per-row ordinal, not on a
+ * non-deterministic clock / RNG), so a default that uses only it plus deterministic
+ * state passes the schema-determinism gate with no `nondeterministic_schema` opt-out.
+ *
+ * Its value lives on {@link RuntimeContext.mutationOrdinal}, set per row by the INSERT
+ * DML executor and the shared-surrogate envelope. It must be emitted via the custom
+ * emitter below (it reads the runtime context, which the default scalar-function path
+ * does not expose), and it errors when evaluated outside a mutation-context scope.
+ *
+ * Nullary + deterministic does **not** make it constant-foldable: the constant-folding
+ * pass folds a functional node only when it has ≥ 1 child and every child is constant
+ * (`planner/analysis/const-pass.ts` `classifyNode`), so a zero-operand call is left
+ * intact and resolves at runtime.
+ */
+function emitMutationOrdinal(_plan, _ctx, _defaultEmit) {
+    function run(rctx) {
+        const ordinal = rctx.mutationOrdinal;
+        if (ordinal === undefined) {
+            throw new QuereusError(`mutation_ordinal() is only valid during INSERT default / mutation-context evaluation`, StatusCode.ERROR);
+        }
+        return ordinal;
+    }
+    return { params: [], run: run, note: 'mutation_ordinal()' };
+}
+export const mutationOrdinalFunc = createScalarFunction({
+    name: 'mutation_ordinal',
+    numArgs: 0,
+    deterministic: true,
+    returnType: { typeClass: 'scalar', logicalType: INTEGER_TYPE, nullable: false, isReadOnly: true },
+}, 
+// The custom emitter handles every call; this direct implementation is only a
+// guard for an unexpected non-emitted invocation.
+() => {
+    throw new QuereusError(`mutation_ordinal() must be emitted via its custom emitter (it reads the runtime mutation context)`, StatusCode.INTERNAL);
+});
+mutationOrdinalFunc.customEmitter = emitMutationOrdinal;
+//# sourceMappingURL=mutation.js.map

package/dist/src/func/builtins/mutation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation.js","sourceRoot":"","sources":["../../../../src/func/builtins/mutation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAI1D,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAmC,MAAM,uBAAuB,CAAC;AAEpF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,SAAS,mBAAmB,CAC3B,KAA6B,EAC7B,IAAqB,EACrB,YAAiF;IAEjF,SAAS,GAAG,CAAC,IAAoB;QAChC,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC;QACrC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,IAAI,YAAY,CACrB,sFAAsF,EACtF,UAAU,CAAC,KAAK,CAChB,CAAC;QACH,CAAC;QACD,OAAO,OAAmB,CAAC;IAC5B,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,GAAqB,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC;AAC/E,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,oBAAoB,CACtD;IACC,IAAI,EAAE,kBAAkB;IACxB,OAAO,EAAE,CAAC;IACV,aAAa,EAAE,IAAI;IACnB,UAAU,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE;CACjG;AACD,8EAA8E;AAC9E,kDAAkD;AAClD,GAAG,EAAE;IACJ,MAAM,IAAI,YAAY,CACrB,mGAAmG,EACnG,UAAU,CAAC,QAAQ,CACnB,CAAC;AACH,CAAC,CACD,CAAC;AAEF,mBAAmB,CAAC,aAAa,GAAG,mBAAmB,CAAC"}

package/dist/src/func/builtins/schema.d.ts

@@ -8,4 +8,6 @@ export declare const uniqueConstraintInfoFunc: import("../../schema/function.js"
 export declare const assertionInfoFunc: import("../../schema/function.js").TableValuedFunctionSchema;
 export declare function classifyFunction(funcSchema: FunctionSchema): string;
 export declare const functionInfoFunc: import("../../schema/function.js").TableValuedFunctionSchema;
+export declare const viewInfoFunc: import("../../schema/function.js").TableValuedFunctionSchema;
+export declare const columnInfoFunc: import("../../schema/function.js").TableValuedFunctionSchema;
 //# sourceMappingURL=schema.d.ts.map

package/dist/src/func/builtins/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/func/builtins/schema.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAgD/D,eAAO,MAAM,UAAU,8DAqHtB,CAAC;AAGF,eAAO,MAAM,aAAa,8DA4DzB,CAAC;AAGF,eAAO,MAAM,kBAAkB,8DAiF9B,CAAC;AAGF,eAAO,MAAM,aAAa,8DA4DzB,CAAC;AAGF,eAAO,MAAM,uBAAuB,8DAmDnC,CAAC;AAGF,eAAO,MAAM,wBAAwB,8DAwDpC,CAAC;AAGF,eAAO,MAAM,iBAAiB,8DAoC7B,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM,CAMnE;AAeD,eAAO,MAAM,gBAAgB,8DA4C5B,CAAC"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/func/builtins/schema.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAwF/D,eAAO,MAAM,UAAU,8DAwHtB,CAAC;AAGF,eAAO,MAAM,aAAa,8DA4DzB,CAAC;AAGF,eAAO,MAAM,kBAAkB,8DAiF9B,CAAC;AAGF,eAAO,MAAM,aAAa,8DAoEzB,CAAC;AAGF,eAAO,MAAM,uBAAuB,8DAmDnC,CAAC;AAGF,eAAO,MAAM,wBAAwB,8DAwDpC,CAAC;AAGF,eAAO,MAAM,iBAAiB,8DAoC7B,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM,CAMnE;AAeD,eAAO,MAAM,gBAAgB,8DA4C5B,CAAC;AAmVF,eAAO,MAAM,YAAY,8DA0DxB,CAAC;AAiSF,eAAO,MAAM,cAAc,8DA4C1B,CAAC"}