@sequenceholdings/orm 2.7.1 → 2.8.2

package/dist/client.d.cts

@@ -86,7 +86,10 @@ declare class TableQuery<Row extends Record<string, unknown>, Result = Row> {
     private filter;
 }
 
+type OperationSelection = 'name';
+
 /** Runtime SQL inputs are values, never interpolated into the submitted SQL. */
+declare const BUILTIN_SQL_READ_NAME = "BuiltinSqlRead";
 declare const BUILTIN_SQL_READ_HASH = "sha256:a50c477c952a5e0fe68ed158a4530e4aab573c09bcbb1a8ac454dc88a39a6258";
 type SqlQueryParameter = {
     type: 'text' | 'uuid' | 'date' | 'timestamptz' | 'numeric' | 'bigint';
@@ -115,9 +118,19 @@ interface SqlQueryResult {
     truncated: boolean;
 }
 
+/**
+ * Persisted-operation client for the v2 data plane. The wire carries only
+ * `{ op: <name>, variables, idempotencyKey?, expectedSourceGeneration? }`. Runtime SQL contracts accept SQL in variables;
+ * GraphQL and fixed SQL operations keep their documents server-side. This runtime
+ * is deliberately free of node builtins and third-
+ * party deps (no @apollo/client import): Apollo integration happens through a
+ * fetch-compatible shim (`createOrmFetch`) handed to `HttpLink({ fetch })`.
+ */
+
 /** One entry of `operations.manifest.json` (generated by `orm generate`). */
 interface ManifestOperation {
-    readonly hash: string;
+    /** Legacy manifests only; requests use the operation name. */
+    readonly hash?: string;
     readonly kind: 'query' | 'mutation';
     readonly requires: {
         readonly capability?: string;
@@ -125,7 +138,8 @@ interface ManifestOperation {
     } | null;
 }
 interface OperationsManifest {
-    readonly schemaHash: string;
+    /** Legacy manifest metadata; absent from newly generated clients. */
+    readonly schemaHash?: string;
     readonly opsHash?: string;
     readonly operations: Readonly<Record<string, ManifestOperation>>;
 }
@@ -134,6 +148,8 @@ interface OperationExecutorConfig {
     baseUrl: string;
     namespace: string;
     manifest?: OperationsManifest;
+    /** Optional compatibility setting; only stable name selection is supported. */
+    operationSelection?: OperationSelection;
     /** App-user / session bearer → `Authorization: Bearer`. */
     getToken?: () => Promise<string | null> | string | null;
     /** Delegated, attenuated function token → the `ORM_DATA_TOKEN_HEADER`. */
@@ -147,7 +163,7 @@ interface OperationExecutionOptions {
     expectedSourceGeneration?: string;
 }
 interface OperationExecutor {
-    /** Execute a manifest operation by name (or a raw `sha256:` hash). */
+    /** Execute a registered operation by its stable name. */
     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. */
@@ -178,13 +194,19 @@ interface TypedReadReceiptOperationExecutor extends TypedOperationExecutor {
 }
 type TypedReadReceiptSqlOperationExecutor = TypedReadReceiptOperationExecutor & ReadReceiptSqlOperationExecutor;
 /** Generated handle identifies the registered contract; optional types are phantom. */
-interface OperationReference<TVariables extends Record<string, unknown>, TData> {
+type OperationReference<TVariables extends Record<string, unknown>, TData> = {
     readonly namespace: string;
-    readonly hash: string;
     readonly variables?: TVariables;
     readonly result?: TData;
-}
-declare function createOperationExecutor({ baseUrl, namespace, manifest, getToken, getDataToken, fetchImpl, }: OperationExecutorConfig): TypedReadReceiptSqlOperationExecutor;
+    readonly kind?: 'query' | 'mutation';
+} & ({
+    readonly name: string;
+    readonly hash?: string;
+} | {
+    readonly hash: string;
+    readonly name?: string;
+});
+declare function createOperationExecutor({ baseUrl, namespace, manifest, operationSelection, getToken, getDataToken, fetchImpl, }: OperationExecutorConfig): TypedReadReceiptSqlOperationExecutor;
 /**
  * Configure the process-wide executor the generated `db<Name>` server
  * functions call through. Call once at startup (server-side); browser apps
@@ -200,7 +222,7 @@ declare function executeOperation<TData = Record<string, unknown>>({ op, variabl
 /**
  * A fetch-compatible function for `new HttpLink({ uri: '/unused', fetch: createOrmFetch(...) })`.
  * Intercepts Apollo's GraphQL POST, swaps the body for the persisted-op
- * envelope (`{ op: <hash>, variables }`) resolved via the manifest's
+ * envelope (`{ op: <name>, variables }`) resolved via the manifest's
  * operationName, rewrites the URL to the data plane, and attaches auth.
  * The GraphQL-spec response body passes through untouched, so InMemoryCache
  * and error links behave exactly as they do against a GraphQL server.
@@ -213,6 +235,7 @@ interface OperationTransportRequest {
     variables: Record<string, unknown>;
     idempotencyKey?: string;
     expectedSourceGeneration?: string;
+    expectedKind?: 'query' | 'mutation';
 }
 interface OperationTransportResponse {
     ok: boolean;
@@ -225,11 +248,12 @@ type OperationTransport = (request: OperationTransportRequest) => Promise<Operat
  * No credential handling, retries, or global configuration. The manifest is
  * validated once and copied, so later caller mutation cannot alter the target.
  */
-declare function createOperationExecutorWithTransport({ namespace, manifest, transport }: {
+declare function createOperationExecutorWithTransport({ namespace, manifest, transport, operationSelection }: {
     namespace: string;
-    /** Accept generated JSON imports directly; validate them at construction. */
+    /** Accept generated JSON imports directly; validate them at construction. Optional under `operationSelection: 'name'`. */
     manifest?: unknown;
     transport: OperationTransport;
+    operationSelection?: OperationSelection;
 }): TypedReadReceiptSqlOperationExecutor;
 
 /** Bindable scalar for `query()` placeholders ($1, $2, …). */
@@ -329,4 +353,4 @@ declare function createServiceOrmClient<Tables extends Record<string, Record<str
     transport?: OrmTransport;
 }): OrmClient<Tables, Actions>;
 
-export { BUILTIN_SQL_READ_HASH, type FilterValue, type ManifestOperation, type OperationErrorEntry, type OperationExecutionOptions, type OperationExecutor, type OperationExecutorConfig, type OperationReadReceipt, type OperationReference, type OperationTransport, type OperationTransportRequest, type OperationTransportResponse, type OperationsManifest, type OrmActionShape, type OrmActions, type OrmClient, OrmClientError, OrmOperationError, type OrmTransport, type QueryParam, type ReadReceiptOperationExecutor, type ReadReceiptSqlOperationExecutor, type ReadResponse, type SqlOperationExecutor, type SqlQueryParameter, type SqlQueryResult, type SqlQueryVariables, TableQuery, type TypedOperationExecutor, type TypedReadReceiptOperationExecutor, type TypedReadReceiptSqlOperationExecutor, type TypedSqlOperationExecutor, configureOrmOperations, createFetchTransport, createOperationExecutor, createOperationExecutorWithTransport, createOrmClient, createOrmFetch, createServiceOrmClient, executeOperation };
+export { BUILTIN_SQL_READ_HASH, BUILTIN_SQL_READ_NAME, type FilterValue, type ManifestOperation, type OperationErrorEntry, type OperationExecutionOptions, type OperationExecutor, type OperationExecutorConfig, type OperationReadReceipt, type OperationReference, type OperationSelection, type OperationTransport, type OperationTransportRequest, type OperationTransportResponse, type OperationsManifest, type OrmActionShape, type OrmActions, type OrmClient, OrmClientError, OrmOperationError, type OrmTransport, type QueryParam, type ReadReceiptOperationExecutor, type ReadReceiptSqlOperationExecutor, type ReadResponse, type SqlOperationExecutor, type SqlQueryParameter, type SqlQueryResult, type SqlQueryVariables, TableQuery, type TypedOperationExecutor, type TypedReadReceiptOperationExecutor, type TypedReadReceiptSqlOperationExecutor, type TypedSqlOperationExecutor, configureOrmOperations, createFetchTransport, createOperationExecutor, createOperationExecutorWithTransport, createOrmClient, createOrmFetch, createServiceOrmClient, executeOperation };

package/dist/client.d.ts

@@ -86,7 +86,10 @@ declare class TableQuery<Row extends Record<string, unknown>, Result = Row> {
     private filter;
 }
 
+type OperationSelection = 'name';
+
 /** Runtime SQL inputs are values, never interpolated into the submitted SQL. */
+declare const BUILTIN_SQL_READ_NAME = "BuiltinSqlRead";
 declare const BUILTIN_SQL_READ_HASH = "sha256:a50c477c952a5e0fe68ed158a4530e4aab573c09bcbb1a8ac454dc88a39a6258";
 type SqlQueryParameter = {
     type: 'text' | 'uuid' | 'date' | 'timestamptz' | 'numeric' | 'bigint';
@@ -115,9 +118,19 @@ interface SqlQueryResult {
     truncated: boolean;
 }
 
+/**
+ * Persisted-operation client for the v2 data plane. The wire carries only
+ * `{ op: <name>, variables, idempotencyKey?, expectedSourceGeneration? }`. Runtime SQL contracts accept SQL in variables;
+ * GraphQL and fixed SQL operations keep their documents server-side. This runtime
+ * is deliberately free of node builtins and third-
+ * party deps (no @apollo/client import): Apollo integration happens through a
+ * fetch-compatible shim (`createOrmFetch`) handed to `HttpLink({ fetch })`.
+ */
+
 /** One entry of `operations.manifest.json` (generated by `orm generate`). */
 interface ManifestOperation {
-    readonly hash: string;
+    /** Legacy manifests only; requests use the operation name. */
+    readonly hash?: string;
     readonly kind: 'query' | 'mutation';
     readonly requires: {
         readonly capability?: string;
@@ -125,7 +138,8 @@ interface ManifestOperation {
     } | null;
 }
 interface OperationsManifest {
-    readonly schemaHash: string;
+    /** Legacy manifest metadata; absent from newly generated clients. */
+    readonly schemaHash?: string;
     readonly opsHash?: string;
     readonly operations: Readonly<Record<string, ManifestOperation>>;
 }
@@ -134,6 +148,8 @@ interface OperationExecutorConfig {
     baseUrl: string;
     namespace: string;
     manifest?: OperationsManifest;
+    /** Optional compatibility setting; only stable name selection is supported. */
+    operationSelection?: OperationSelection;
     /** App-user / session bearer → `Authorization: Bearer`. */
     getToken?: () => Promise<string | null> | string | null;
     /** Delegated, attenuated function token → the `ORM_DATA_TOKEN_HEADER`. */
@@ -147,7 +163,7 @@ interface OperationExecutionOptions {
     expectedSourceGeneration?: string;
 }
 interface OperationExecutor {
-    /** Execute a manifest operation by name (or a raw `sha256:` hash). */
+    /** Execute a registered operation by its stable name. */
     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. */
@@ -178,13 +194,19 @@ interface TypedReadReceiptOperationExecutor extends TypedOperationExecutor {
 }
 type TypedReadReceiptSqlOperationExecutor = TypedReadReceiptOperationExecutor & ReadReceiptSqlOperationExecutor;
 /** Generated handle identifies the registered contract; optional types are phantom. */
-interface OperationReference<TVariables extends Record<string, unknown>, TData> {
+type OperationReference<TVariables extends Record<string, unknown>, TData> = {
     readonly namespace: string;
-    readonly hash: string;
     readonly variables?: TVariables;
     readonly result?: TData;
-}
-declare function createOperationExecutor({ baseUrl, namespace, manifest, getToken, getDataToken, fetchImpl, }: OperationExecutorConfig): TypedReadReceiptSqlOperationExecutor;
+    readonly kind?: 'query' | 'mutation';
+} & ({
+    readonly name: string;
+    readonly hash?: string;
+} | {
+    readonly hash: string;
+    readonly name?: string;
+});
+declare function createOperationExecutor({ baseUrl, namespace, manifest, operationSelection, getToken, getDataToken, fetchImpl, }: OperationExecutorConfig): TypedReadReceiptSqlOperationExecutor;
 /**
  * Configure the process-wide executor the generated `db<Name>` server
  * functions call through. Call once at startup (server-side); browser apps
@@ -200,7 +222,7 @@ declare function executeOperation<TData = Record<string, unknown>>({ op, variabl
 /**
  * A fetch-compatible function for `new HttpLink({ uri: '/unused', fetch: createOrmFetch(...) })`.
  * Intercepts Apollo's GraphQL POST, swaps the body for the persisted-op
- * envelope (`{ op: <hash>, variables }`) resolved via the manifest's
+ * envelope (`{ op: <name>, variables }`) resolved via the manifest's
  * operationName, rewrites the URL to the data plane, and attaches auth.
  * The GraphQL-spec response body passes through untouched, so InMemoryCache
  * and error links behave exactly as they do against a GraphQL server.
@@ -213,6 +235,7 @@ interface OperationTransportRequest {
     variables: Record<string, unknown>;
     idempotencyKey?: string;
     expectedSourceGeneration?: string;
+    expectedKind?: 'query' | 'mutation';
 }
 interface OperationTransportResponse {
     ok: boolean;
@@ -225,11 +248,12 @@ type OperationTransport = (request: OperationTransportRequest) => Promise<Operat
  * No credential handling, retries, or global configuration. The manifest is
  * validated once and copied, so later caller mutation cannot alter the target.
  */
-declare function createOperationExecutorWithTransport({ namespace, manifest, transport }: {
+declare function createOperationExecutorWithTransport({ namespace, manifest, transport, operationSelection }: {
     namespace: string;
-    /** Accept generated JSON imports directly; validate them at construction. */
+    /** Accept generated JSON imports directly; validate them at construction. Optional under `operationSelection: 'name'`. */
     manifest?: unknown;
     transport: OperationTransport;
+    operationSelection?: OperationSelection;
 }): TypedReadReceiptSqlOperationExecutor;
 
 /** Bindable scalar for `query()` placeholders ($1, $2, …). */
@@ -329,4 +353,4 @@ declare function createServiceOrmClient<Tables extends Record<string, Record<str
     transport?: OrmTransport;
 }): OrmClient<Tables, Actions>;
 
-export { BUILTIN_SQL_READ_HASH, type FilterValue, type ManifestOperation, type OperationErrorEntry, type OperationExecutionOptions, type OperationExecutor, type OperationExecutorConfig, type OperationReadReceipt, type OperationReference, type OperationTransport, type OperationTransportRequest, type OperationTransportResponse, type OperationsManifest, type OrmActionShape, type OrmActions, type OrmClient, OrmClientError, OrmOperationError, type OrmTransport, type QueryParam, type ReadReceiptOperationExecutor, type ReadReceiptSqlOperationExecutor, type ReadResponse, type SqlOperationExecutor, type SqlQueryParameter, type SqlQueryResult, type SqlQueryVariables, TableQuery, type TypedOperationExecutor, type TypedReadReceiptOperationExecutor, type TypedReadReceiptSqlOperationExecutor, type TypedSqlOperationExecutor, configureOrmOperations, createFetchTransport, createOperationExecutor, createOperationExecutorWithTransport, createOrmClient, createOrmFetch, createServiceOrmClient, executeOperation };
+export { BUILTIN_SQL_READ_HASH, BUILTIN_SQL_READ_NAME, type FilterValue, type ManifestOperation, type OperationErrorEntry, type OperationExecutionOptions, type OperationExecutor, type OperationExecutorConfig, type OperationReadReceipt, type OperationReference, type OperationSelection, type OperationTransport, type OperationTransportRequest, type OperationTransportResponse, type OperationsManifest, type OrmActionShape, type OrmActions, type OrmClient, OrmClientError, OrmOperationError, type OrmTransport, type QueryParam, type ReadReceiptOperationExecutor, type ReadReceiptSqlOperationExecutor, type ReadResponse, type SqlOperationExecutor, type SqlQueryParameter, type SqlQueryResult, type SqlQueryVariables, TableQuery, type TypedOperationExecutor, type TypedReadReceiptOperationExecutor, type TypedReadReceiptSqlOperationExecutor, type TypedSqlOperationExecutor, configureOrmOperations, createFetchTransport, createOperationExecutor, createOperationExecutorWithTransport, createOrmClient, createOrmFetch, createServiceOrmClient, executeOperation };

package/dist/client.js

@@ -159,6 +159,51 @@ var TableQuery = class _TableQuery {
   }
 };
 
+// src/client/sql.ts
+var BUILTIN_SQL_READ_NAME = "BuiltinSqlRead";
+var BUILTIN_SQL_READ_HASH = "sha256:a50c477c952a5e0fe68ed158a4530e4aab573c09bcbb1a8ac454dc88a39a6258";
+
+// src/client/operation-selection.ts
+var NAME = /^[_A-Za-z][_0-9A-Za-z]{0,254}$/;
+function selectorForReference(op) {
+  if (typeof op === "string") return op;
+  if (op.name) return op.name;
+  if (op.hash?.startsWith("sha256:")) return op.hash;
+  throw new OrmClientError("unknown operation reference \u2014 regenerate the client");
+}
+function manifestEntry({ selector, operations }) {
+  if (selector.startsWith("sha256:")) return [...operations].find(([, entry2]) => entry2.hash === selector);
+  const entry = operations.get(selector);
+  return entry ? [selector, entry] : void 0;
+}
+function referenceKind(op) {
+  return typeof op === "string" ? void 0 : op.kind;
+}
+function assertKnownName({ name, known, operations, selector }) {
+  if (!NAME.test(name) || !known || ["__proto__", "constructor", "prototype"].includes(name)) {
+    throw new OrmClientError(`unknown operation "${selector}" \u2014 not in the manifest (${operations.size} known); regenerate the typed operation reference`);
+  }
+}
+function assertReferenceKind({ op, kind }) {
+  const declared = referenceKind(op);
+  if (declared && kind !== declared) throw new OrmClientError("operation kind differs from the typed reference");
+}
+function selectOperationTarget({ op, operations, selection = "name", readReceipt = false }) {
+  if (selection !== "name") throw new OrmClientError("ORM calls use operation names; hash selection is no longer supported");
+  const selector = selectorForReference(op);
+  if (selector === BUILTIN_SQL_READ_HASH || selector === BUILTIN_SQL_READ_NAME) {
+    return { op: `query:${BUILTIN_SQL_READ_NAME}`, expectedKind: "query" };
+  }
+  const match = manifestEntry({ selector, operations });
+  const name = match?.[0] ?? selector;
+  const kind = match?.[1].kind ?? referenceKind(op);
+  assertKnownName({ name, known: operations.size === 0 || match !== void 0, operations, selector });
+  assertReferenceKind({ op, kind });
+  if (readReceipt && kind !== "query") throw new OrmClientError("read receipts require a registered query or the built-in SQL read");
+  const guarded = kind ? `${kind}:${name}` : name;
+  return { op: guarded, ...kind ? { expectedKind: kind } : {} };
+}
+
 // src/client/response.ts
 function isRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -206,9 +251,6 @@ function readOperationResponseWithReceipt({
   return { data, sourceGeneration };
 }
 
-// src/client/sql.ts
-var BUILTIN_SQL_READ_HASH = "sha256:a50c477c952a5e0fe68ed158a4530e4aab573c09bcbb1a8ac454dc88a39a6258";
-
 // src/client/operations.ts
 function validateIdempotencyKey(key) {
   if (key !== void 0 && !/^[A-Za-z0-9._:-]{1,128}$/.test(key)) {
@@ -221,38 +263,11 @@ function validateExpectedSourceGeneration(value) {
   }
 }
 var dataPlanePath = (namespace) => `/_data/v2/${namespace}`;
-function resolveOpHash(manifest, op) {
-  if (op.startsWith("sha256:")) return op;
-  const entry = manifest.operations[op];
-  if (!entry) {
-    const known = Object.keys(manifest.operations).sort();
-    throw new OrmClientError(
-      `unknown operation "${op}" \u2014 not in the manifest (${known.length} known). Re-run \`seq-studio orm generate\` after editing graphql documents.`
-    );
-  }
-  return entry.hash;
-}
-function createReadReceiptOperationResolver({ operations }) {
-  const hashesByName = /* @__PURE__ */ new Map();
-  const readHashes = /* @__PURE__ */ new Set([BUILTIN_SQL_READ_HASH]);
-  const mutationHashes = /* @__PURE__ */ new Set();
-  for (const [name, entry] of operations) {
-    hashesByName.set(name, entry.hash);
-    if (entry.kind === "query" && /^sha256:[a-f0-9]{64}$/.test(entry.hash)) readHashes.add(entry.hash);
-    if (entry.kind === "mutation") mutationHashes.add(entry.hash);
-  }
-  return ({ selector, hashOnly = false }) => {
-    const hash = selector.startsWith("sha256:") ? selector : hashOnly ? void 0 : hashesByName.get(selector);
-    if (!hash || !readHashes.has(hash) || mutationHashes.has(hash)) {
-      throw new OrmClientError("read receipts require a registered query or the built-in SQL read");
-    }
-    return hash;
-  };
-}
 function createOperationExecutor({
   baseUrl,
   namespace,
-  manifest = { schemaHash: "builtin", operations: {} },
+  manifest = { operations: {} },
+  operationSelection = "name",
   getToken,
   getDataToken,
   fetchImpl = globalThis.fetch
@@ -262,12 +277,12 @@ function createOperationExecutor({
     throw new OrmClientError("provide exactly one of getToken (bearer) or getDataToken (delegated)");
   }
   const root = baseUrl.replace(/\/+$/, "");
-  const resolveReceiptOperation = createReadReceiptOperationResolver({ operations: Object.entries(manifest.operations) });
+  const operations = new Map(Object.entries(manifest.operations).map(([name, entry]) => [name, { ...entry }]));
   async function request({ op, variables, options, requireReadReceipt = false }) {
     validateIdempotencyKey(options.idempotencyKey);
     validateExpectedSourceGeneration(options.expectedSourceGeneration);
     if (typeof op !== "string" && op.namespace !== namespace) throw new OrmClientError("operation belongs to a different namespace");
-    const hash = requireReadReceipt ? resolveReceiptOperation({ selector: typeof op === "string" ? op : op.hash, hashOnly: typeof op !== "string" }) : typeof op === "string" ? resolveOpHash(manifest, op) : op.hash;
+    const target = selectOperationTarget({ op, operations, selection: operationSelection, readReceipt: requireReadReceipt });
     const token = await (getDataToken ?? getToken)();
     if (!token) throw new OrmClientError("not authenticated \u2014 no token available");
     const auth = getDataToken ? { [ORM_DATA_TOKEN_HEADER]: token } : { Authorization: `Bearer ${token}` };
@@ -275,7 +290,7 @@ function createOperationExecutor({
       method: "POST",
       headers: { ...auth, "Content-Type": "application/json" },
       body: JSON.stringify({
-        op: hash,
+        ...target,
         variables,
         idempotencyKey: options.idempotencyKey,
         expectedSourceGeneration: options.expectedSourceGeneration
@@ -340,7 +355,7 @@ function createOrmFetch({
         "createOrmFetch requires named operations (Apollo sends operationName for named documents)"
       );
     }
-    const hash = resolveOpHash(manifest, name);
+    const target = selectOperationTarget({ op: name, operations: new Map(Object.entries(manifest.operations)) });
     const idempotencyKey = new Headers(init?.headers).get("Idempotency-Key") ?? void 0;
     validateIdempotencyKey(idempotencyKey);
     const token = await (getDataToken ?? getToken)();
@@ -349,7 +364,7 @@ function createOrmFetch({
     return fetchImpl(url, {
       method: "POST",
       headers: { ...auth, "Content-Type": "application/json" },
-      body: JSON.stringify({ op: hash, variables: parsed.variables ?? {}, idempotencyKey }),
+      body: JSON.stringify({ ...target, variables: parsed.variables ?? {}, idempotencyKey }),
       ...init?.signal ? { signal: init.signal } : {}
     });
   };
@@ -357,39 +372,37 @@ function createOrmFetch({
 
 // src/client/transport-executor.ts
 var operationHash = /^sha256:[a-f0-9]{64}$/;
-function readManifestHashes(manifest) {
-  if (!isRecord(manifest) || typeof manifest.schemaHash !== "string" || !manifest.schemaHash || !isRecord(manifest.operations)) {
+function readManifestOperations(manifest) {
+  if (!isRecord(manifest) || !isRecord(manifest.operations)) {
     throw new OrmClientError("invalid operations manifest \u2014 use operations.manifest.json from seq-studio orm generate");
   }
-  const hashes = /* @__PURE__ */ new Map();
+  const operations = /* @__PURE__ */ new Map();
   for (const [name, entry] of Object.entries(manifest.operations)) {
-    if (!/^[_A-Za-z][_0-9A-Za-z]*$/.test(name) || !isRecord(entry) || typeof entry.hash !== "string" || !operationHash.test(entry.hash) || entry.kind !== "query" && entry.kind !== "mutation") {
+    if (!/^[_A-Za-z][_0-9A-Za-z]*$/.test(name) || !isRecord(entry) || entry.hash !== void 0 && (typeof entry.hash !== "string" || !operationHash.test(entry.hash)) || entry.kind !== "query" && entry.kind !== "mutation") {
       throw new OrmClientError(`invalid operations manifest entry "${name}" \u2014 regenerate the manifest`);
     }
-    hashes.set(name, { hash: entry.hash, kind: entry.kind });
+    operations.set(name, { ...typeof entry.hash === "string" ? { hash: entry.hash } : {}, kind: entry.kind });
   }
-  return hashes;
+  return operations;
 }
-function createOperationExecutorWithTransport({ namespace, manifest, transport }) {
+function createOperationExecutorWithTransport({ namespace, manifest, transport, operationSelection = "name" }) {
+  if (operationSelection !== "name") throw new OrmClientError("ORM calls use operation names; hash selection is no longer supported");
   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 = manifest === void 0 ? /* @__PURE__ */ new Map() : readManifestHashes(manifest);
-  const knownHashes = new Set([...hashes.values()].map((entry) => entry.hash));
-  const resolveReceiptOperation = createReadReceiptOperationResolver({ operations: hashes });
+  const operations = manifest === void 0 ? /* @__PURE__ */ new Map() : readManifestOperations(manifest);
   async function request({ op, variables, options, requireReadReceipt = false }) {
     validateIdempotencyKey(options.idempotencyKey);
     validateExpectedSourceGeneration(options.expectedSourceGeneration);
     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 = requireReadReceipt ? resolveReceiptOperation({ selector, hashOnly: typeof op !== "string" }) : selector === BUILTIN_SQL_READ_HASH ? selector : hashes.get(selector)?.hash ?? (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.`);
+    const target = selectOperationTarget({ op, operations, selection: operationSelection, readReceipt: requireReadReceipt });
     if (!isRecord(variables)) throw new OrmClientError("operation variables must be an object");
-    const response = await transport({
+    const send = () => transport({
       namespace,
-      op: hash,
+      ...target,
       variables,
       ...options.idempotencyKey === void 0 ? {} : { idempotencyKey: options.idempotencyKey },
       ...options.expectedSourceGeneration === void 0 ? {} : { expectedSourceGeneration: options.expectedSourceGeneration }
     });
+    const response = await send();
     if (!response || typeof response.ok !== "boolean" || !Number.isInteger(response.status) || response.status < 100 || response.status > 599 || response.ok !== (response.status >= 200 && response.status < 300)) {
       throw new OrmOperationError("malformed transport response", null, null);
     }
@@ -475,6 +488,6 @@ function requireOption(value, name) {
   return value;
 }
 
-export { BUILTIN_SQL_READ_HASH, NAMESPACE_PATTERN, ORM_DATA_TOKEN_HEADER, ORM_SERVICE_DATA_TOKEN_HEADER, OrmClientError, OrmOperationError, TableQuery, configureOrmOperations, createFetchTransport, createOperationExecutor, createOperationExecutorWithTransport, createOrmClient, createOrmFetch, createServiceOrmClient, executeOperation };
+export { BUILTIN_SQL_READ_HASH, BUILTIN_SQL_READ_NAME, NAMESPACE_PATTERN, ORM_DATA_TOKEN_HEADER, ORM_SERVICE_DATA_TOKEN_HEADER, OrmClientError, OrmOperationError, TableQuery, configureOrmOperations, createFetchTransport, createOperationExecutor, createOperationExecutorWithTransport, createOrmClient, createOrmFetch, createServiceOrmClient, executeOperation };
 //# sourceMappingURL=client.js.map
 //# sourceMappingURL=client.js.map