@sequenceholdings/orm 2.8.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;
@@ -220,14 +243,6 @@ interface OperationTransportResponse {
     body: unknown;
 }
 type OperationTransport = (request: OperationTransportRequest) => Promise<OperationTransportResponse>;
-/**
- * How a string selector reaches the server. `hash` (the default) resolves the
- * name through the manifest and sends the hash, pinning the exact contract the
- * caller was generated against. `name` sends the name itself, resolved by the
- * server against the namespace's active version when the request runs, so the
- * caller survives the rehash every schema change causes and needs no manifest.
- */
-type OperationSelection = 'hash' | 'name';
 /**
  * Execute generated operations through a host-owned authenticated transport.
  * No credential handling, retries, or global configuration. The manifest is
@@ -338,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 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 };
+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;
@@ -220,14 +243,6 @@ interface OperationTransportResponse {
     body: unknown;
 }
 type OperationTransport = (request: OperationTransportRequest) => Promise<OperationTransportResponse>;
-/**
- * How a string selector reaches the server. `hash` (the default) resolves the
- * name through the manifest and sends the hash, pinning the exact contract the
- * caller was generated against. `name` sends the name itself, resolved by the
- * server against the namespace's active version when the request runs, so the
- * caller survives the rehash every schema change causes and needs no manifest.
- */
-type OperationSelection = 'hash' | 'name';
 /**
  * Execute generated operations through a host-owned authenticated transport.
  * No credential handling, retries, or global configuration. The manifest is
@@ -338,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 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 };
+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,57 +372,37 @@ function createOrmFetch({
 
 // src/client/transport-executor.ts
 var operationHash = /^sha256:[a-f0-9]{64}$/;
-var operationName = /^[_A-Za-z][_0-9A-Za-z]{0,254}$/;
-function refusedAsUnknownSelector(response) {
-  if (response.status !== 404 || !isRecord(response.body) || !Array.isArray(response.body.errors)) return false;
-  const first = response.body.errors[0];
-  const extensions = isRecord(first) && isRecord(first.extensions) ? first.extensions : void 0;
-  return extensions?.code === "NOT_FOUND" && !(isRecord(extensions.details) && extensions.details.cause === "unknown_operation") && isRecord(first) && typeof first.message === "string" && first.message.startsWith("operation not found");
-}
-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, operationSelection = "hash" }) {
-  if (operationSelection !== "hash" && operationSelection !== "name") throw new OrmClientError("operationSelection must be 'hash' or 'name'");
+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 });
-  function selectTarget({ op, requireReadReceipt }) {
-    const selector = typeof op === "string" ? op : op.hash;
-    if (operationSelection === "name" && !requireReadReceipt && typeof op === "string" && operationName.test(op)) {
-      return { target: op, byName: true };
-    }
-    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 "${String(op)}" \u2014 not in the manifest (${hashes.size} known). Re-run seq-studio orm generate.`);
-    return { target: hash, byName: false };
-  }
+  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 { target: hash, byName } = selectTarget({ op, requireReadReceipt });
+    const target = selectOperationTarget({ op, operations, selection: operationSelection, readReceipt: requireReadReceipt });
     if (!isRecord(variables)) throw new OrmClientError("operation variables must be an object");
-    const send = (target) => transport({
+    const send = () => transport({
       namespace,
-      op: target,
+      ...target,
       variables,
       ...options.idempotencyKey === void 0 ? {} : { idempotencyKey: options.idempotencyKey },
       ...options.expectedSourceGeneration === void 0 ? {} : { expectedSourceGeneration: options.expectedSourceGeneration }
     });
-    let response = await send(hash);
-    const fallback = byName && typeof op === "string" ? hashes.get(op)?.hash : void 0;
-    if (fallback && response && refusedAsUnknownSelector(response)) response = await send(fallback);
+    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);
     }
@@ -493,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