@sequenceholdings/managed-functions 0.3.5 → 0.4.0

package/README.md

@@ -13,6 +13,29 @@ function consumer or branch on a function ID.
 
 ## ORM as the invoking user
 
+### Default SQL (planned SDK 0.4.0)
+
+With the matching Atlas runtime, use the same caller-scoped executor without
+an operation manifest:
+
+```ts
+const orm = createFunctionOrmExecutor({ request, baseUrl: platformOrigin, namespace: 'lending' })
+const result = await orm.sql({
+  sql: `SELECT l.id, c.name FROM lending.loans l
+    JOIN party.customers c ON c.id = l."customerId"`,
+})
+```
+
+The invocation still needs its existing declared data bindings covering every
+read object, including policy dependencies. SQL does not grant extra access.
+Namespace access, row policies, foreign exports and optional consumer contracts
+remain enforced. Results contain `columns`, array-valued `rows`, and `truncated`;
+numeric/bigint SQL results are always exact strings. Read-only SELECT queries
+are bounded to 1,000 rows / 8 MiB. Source versions are not proof of publication
+or server rollout; the registered-operation workflow below remains supported.
+
+### Registered operations
+
 Available in SDK **0.2.0 and later**. Install the SDK in the function package;
 the separate ORM authoring/compiler package is not needed in the deployed
 function. Copy the namespace's generated `operations.manifest.json` into that

package/dist/orm.d.ts

@@ -15,6 +15,29 @@ declare class OrmOperationError extends OrmClientError {
     readonly name = "OrmOperationError";
     constructor(message: string, status: number | null, code: string | null, errors?: readonly OperationErrorEntry[]);
 }
+type SqlQueryParameter = {
+    type: 'text' | 'uuid' | 'date' | 'timestamptz' | 'numeric' | 'bigint';
+    value: string | null;
+} | {
+    type: 'integer' | 'double';
+    value: number | null;
+} | {
+    type: 'boolean';
+    value: boolean | null;
+};
+type SqlQueryVariables = {
+    sql: string;
+    parameters?: Record<string, SqlQueryParameter>;
+};
+interface SqlQueryResult {
+    columns: Array<{
+        name: string;
+        type: string;
+        nullable: boolean;
+    }>;
+    rows: Array<Array<string | number | boolean | null>>;
+    truncated: boolean;
+}
 
 /** One entry of `operations.manifest.json` (generated by `orm generate`). */
 interface ManifestOperation {
@@ -38,6 +61,11 @@ interface OperationExecutor {
     /** Execute a manifest operation by name (or a raw `sha256:` hash). */
     execute<TData = Record<string, unknown>>(op: string, variables?: Record<string, unknown>, options?: OperationExecutionOptions): Promise<TData>;
 }
+/** Additive factory result; existing host wrappers implementing OperationExecutor remain valid. */
+interface SqlOperationExecutor extends OperationExecutor {
+    /** Default read-only ontology SQL; no authored operation or manifest needed. */
+    sql(variables: SqlQueryVariables): Promise<SqlQueryResult>;
+}
 
 type FunctionOrmErrorCode = 'INVALID_CONFIGURATION' | 'MISSING_CALLER_CONTEXT' | 'INVALID_CALLER_CONTEXT' | 'UNSUPPORTED_CALLER' | 'EXPIRED_CALLER_CONTEXT';
 declare class FunctionOrmError extends Error {
@@ -55,11 +83,11 @@ interface FunctionOrmExecutorOptions {
     request: FunctionOrmRequest;
     baseUrl: string;
     namespace: string;
-    manifest: unknown;
+    manifest?: unknown;
     fetchImpl?: typeof globalThis.fetch;
     jsonScalars?: FunctionOrmJsonScalars;
 }
-declare function createFunctionOrmExecutor({ request, fetchImpl, ...options }: FunctionOrmExecutorOptions): OperationExecutor;
-declare function createFunctionServiceOrmExecutor({ request, fetchImpl, ...options }: FunctionOrmExecutorOptions): OperationExecutor;
+declare function createFunctionOrmExecutor({ request, fetchImpl, ...options }: FunctionOrmExecutorOptions): SqlOperationExecutor;
+declare function createFunctionServiceOrmExecutor({ request, fetchImpl, ...options }: FunctionOrmExecutorOptions): SqlOperationExecutor;
 
-export { FunctionOrmError, type FunctionOrmErrorCode, type FunctionOrmExecutorOptions, type FunctionOrmJsonScalars, type FunctionOrmRequest, ORM_JSON_SCALARS_HEADER, ORM_LOSSLESS_JSON_SCALARS, type OperationExecutor, type OperationsManifest, OrmClientError, OrmOperationError, createFunctionOrmExecutor, createFunctionServiceOrmExecutor };
+export { FunctionOrmError, type FunctionOrmErrorCode, type FunctionOrmExecutorOptions, type FunctionOrmJsonScalars, type FunctionOrmRequest, ORM_JSON_SCALARS_HEADER, ORM_LOSSLESS_JSON_SCALARS, type OperationExecutor, type OperationsManifest, OrmClientError, OrmOperationError, type SqlOperationExecutor, createFunctionOrmExecutor, createFunctionServiceOrmExecutor };

package/dist/orm.js

@@ -82,6 +82,7 @@ function readOperationResponse({
   }
   return payload.data;
 }
+var BUILTIN_SQL_READ_HASH = "sha256:a50c477c952a5e0fe68ed158a4530e4aab573c09bcbb1a8ac454dc88a39a6258";
 function validateIdempotencyKey(key) {
   if (key !== void 0 && !/^[A-Za-z0-9._:-]{1,128}$/.test(key)) {
     throw new OrmClientError("idempotencyKey must be 1\u2013128 letters, digits, dots, underscores, colons or hyphens");
@@ -103,13 +104,13 @@ function readManifestHashes(manifest) {
 }
 function createOperationExecutorWithTransport({ namespace, manifest, transport }) {
   if (typeof namespace !== "string" || !NAMESPACE_PATTERN.test(namespace)) throw new OrmClientError("invalid ORM namespace \u2014 expected a lowercase identifier of at most 41 characters");
-  const hashes = readManifestHashes(manifest);
+  const hashes = manifest === void 0 ? /* @__PURE__ */ new Map() : readManifestHashes(manifest);
   const knownHashes = new Set(hashes.values());
   async function execute(op, variables = {}, options = {}) {
     validateIdempotencyKey(options.idempotencyKey);
     if (typeof op !== "string" && op.namespace !== namespace) throw new OrmClientError("operation belongs to a different namespace");
     const selector = typeof op === "string" ? op : op.hash;
-    const hash = hashes.get(selector) ?? (knownHashes.has(selector) ? selector : void 0);
+    const hash = selector === BUILTIN_SQL_READ_HASH ? selector : hashes.get(selector) ?? (knownHashes.has(selector) ? selector : void 0);
     if (!hash) throw new OrmClientError(`unknown operation "${op}" \u2014 not in the manifest (${hashes.size} known). Re-run seq-studio orm generate.`);
     if (!isRecord(variables)) throw new OrmClientError("operation variables must be an object");
     const response = await transport({
@@ -123,7 +124,7 @@ function createOperationExecutorWithTransport({ namespace, manifest, transport }
     }
     return readOperationResponse(response);
   }
-  return { execute };
+  return { execute, sql: (variables) => execute(BUILTIN_SQL_READ_HASH, variables) };
 }
 
 // src/orm.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sequenceholdings/managed-functions",
-  "version": "0.3.5",
+  "version": "0.4.0",
   "description": "Managed Function context and opt-in cache runtime",
   "license": "UNLICENSED",
   "main": "./dist/index.js",
@@ -48,7 +48,7 @@
     "vitest": "^4.1.11",
     "esbuild": "^0.25.0",
     "tsup": "^8.3.0",
-    "@sequenceholdings/orm": "2.5.0"
+    "@sequenceholdings/orm": "2.6.0"
   },
   "engines": {
     "node": ">=20"