@lunora/codegen 1.0.0-alpha.312 → 1.0.0-alpha.313

package/dist/index.d.mts

@@ -5,8 +5,9 @@ import { LunoraError } from '@lunora/errors';
 export { MESSAGE_SOLUTIONS as LUNORA_SOLUTION_RULES, type Solution as LunoraSolution, type SolutionRule as LunoraSolutionRule, findSolutionByMessage as findLunoraSolution } from '@lunora/errors';
 import { Schema } from '@lunora/server';
 import { JsonSchema } from '@lunora/values';
-import { LanguageName } from 'quicktype-core';
+export { type OpenRpcDocument, type OpenRpcMethod, type RuntimeVerb, SDK_LANGUAGES, SDK_TARGETS, type SdkFiles, type SdkMethod, type SdkNamespace, type SdkRenderInput, type SdkResult, type SdkTarget, generateSdk, isTypedSchema } from "./sdk/index.mjs";
 import { StudioFeaturesResult } from '@lunora/shard-engine';
+import 'quicktype-core';
 /**
  * The architecture manifest — `_generated/architecture.json` — shared by the
  * codegen that builds it, the runtime that serves it at
@@ -4604,295 +4605,9 @@ declare const validatorIrToJsonSchema: (validator: ValidatorIR) => JsonSchema;
  * the contract; clients switch on `error.code`. Kept sorted for stable output.
  */
 declare const LUNORA_ERROR_CODES: ReadonlyArray<string>;
-/**
- * Language-agnostic half of SDK generation: turn an OpenRPC document
- * (`_generated/openrpc.json`, see {@link file://../openrpc.ts}) into the parsed
- * shape every per-language target renders from.
- *
- * Nothing here knows about a target language. A target supplies its own member
- * naming and templates (see {@link file://./targets}); everything that would
- * otherwise be re-derived per language — how a `functionPath` splits, which
- * runtime verb a kind maps to, whether a schema is real or the untyped
- * placeholder, how namespaces group and sort — lives here exactly once.
- *
- * That single-source rule is not stylistic. `paths.ts` documents the same
- * discipline for namespaces ("if these ever disagree, runtime dispatch silently
- * misses functions"), and the failure mode here is the same in a new costume: a
- * target that re-derives a model name renders an import pointing at a class
- * quicktype never emitted.
- *
- * Deriving names in one place is necessary but NOT sufficient, because only
- * half the decision is ours: quicktype chooses whether a predicted name becomes
- * a declared type, and different backends answer differently for the same
- * schema. {@link withDeclaredModels} reconciles the two halves before a target
- * renders anything.
- */
-/** One OpenRPC method as {@link file://../openrpc.ts} emits it. */
-interface OpenRpcMethod {
-  name: string;
-  params?: ReadonlyArray<{
-    name: string;
-    schema?: Record<string, unknown>;
-  }>;
-  result?: {
-    name: string;
-    schema?: Record<string, unknown>;
-  };
-  summary?: string;
-  "x-lunora-function-kind"?: string;
-}
-/** The `_generated/openrpc.json` document. */
-interface OpenRpcDocument {
-  info?: {
-    title?: string;
-    version?: string;
-  };
-  methods: ReadonlyArray<OpenRpcMethod>;
-}
-/** The runtime verbs a generated SDK can call. Mirrors the client transports. */
-type RuntimeVerb = "action" | "mutation" | "query";
-/** One RPC function, parsed and language-neutral. */
-interface SdkMethod {
-  /**
-   * Where this function's ARGUMENT nulls mean "unset" and where they mean
-   * "null" — see {@link ModelNullPaths}.
-   *
-   * On the method rather than on a shared render input because it is a
-   * per-method fact and the parser already holds the schema it comes from. Read
-   * by the three targets whose rendered models cannot tell the two apart
-   * (ruby, rust, swift); the other five have a marker of their own and ignore
-   * it.
-   */
-  argsNullPaths: ModelNullPaths;
-  /**
-   * Generated args model name, or `undefined` when NO model could be named for
-   * this function's arguments.
-   *
-   * `undefined` does NOT mean "takes no arguments" — see {@link SdkMethod.takesArgs}.
-   * A schema carrying a `v.bigint()` or `v.bytes()` gets no model deliberately
-   * (`hasUnrepresentableWireType`), and a backend that cannot name a shape leaves
-   * it undeclared. Both still take arguments, just untyped ones.
-   */
-  argsType: string | undefined;
-  /** Raw exported function name (`"list"`), before any naming convention. */
-  functionName: string;
-  /** The wire identifier (`"messages:list"`), emitted verbatim into calls. */
-  functionPath: string;
-  /** Raw file namespace (`"messages"`), before any naming convention. */
-  namespace: string;
-  /** Generated result model name, or `undefined` while the result is untyped. */
-  resultType: string | undefined;
-  /** Human summary for the doc comment. */
-  summary: string;
-  /**
-   * Whether this function declares arguments at all, independent of whether a
-   * model could be named for them.
-   *
-   * A target emits three shapes from this: a TYPED parameter when `argsType` is
-   * set, an UNTYPED wire-shaped parameter when it is not but this is true, and no
-   * parameter at all when this is false. Collapsing the middle case into the last
-   * is what made `v.bigint()` functions uncallable with arguments.
-   */
-  takesArgs: boolean;
-  /** Which runtime verb this dispatches to. */
-  verb: RuntimeVerb;
-}
-/** One namespace's functions, sorted. */
-interface SdkNamespace {
-  methods: ReadonlyArray<SdkMethod>;
-  /** Raw namespace (`"messages"`); a target applies its own casing. */
-  name: string;
-}
-/**
- * True when a schema actually describes a shape.
- *
- * `openrpc.ts` emits a description-only placeholder for any function without a
- * declared `.output()` (the return type is TS-inferred and absent from the IR).
- * A placeholder must never become a generated model: quicktype would render an
- * empty type, and the surface would decode every response into it — silently
- * discarding the real payload rather than leaving it untyped.
- */
-declare const isTypedSchema: (schema: Record<string, unknown> | undefined) => boolean;
-/**
- * A path from a model's root to one property. `*` stands for every element of an
- * array or every value of a record, neither of which has named positions.
- */
-type SchemaPath = ReadonlyArray<string>;
-/**
- * Where a model's nulls mean different things — the one fact a generated model
- * flattens away, and the reason three ports could not send a `v.nullable()`
- * argument at all.
- *
- * An unset `v.optional()` and a `v.nullable()` set to null are the SAME value in
- * every generated model (a nil field), and opposite things on the wire: the
- * validator rejects an explicit null for the first and requires the key present
- * for the second. Neither Ruby, Rust nor Swift renders a marker telling them
- * apart, so the distinction is computed here, from the schema, where `required`
- * still exists — and handed to the targets that need it.
- *
- * Two lists rather than one because the ports need opposite operations. Ruby and
- * Rust project a whole value tree and prune nulls, so they prune at
- * {@link ModelNullPaths.optional} and nowhere else — which also stops them
- * dropping a legitimate null inside a record or an array, as a blanket prune
- * does. Swift's `JSONEncoder` has already dropped every struct-property nil
- * before the transport sees a tree, so it restores nulls at
- * {@link ModelNullPaths.nullable} instead: an absent key at a required path can
- * only have been a nil, so putting the null back is exact.
- *
- * A `$ref` is NOT resolved. `openrpc.ts` inlines everything it emits, so this
- * never comes up for a generated document — but `--spec` accepts a hand-written
- * one, and there a `$ref`'d sub-object contributes no paths at all: the ports
- * that prune would send its unset optionals as null, and Swift would not restore
- * its nullables. Inline the schema, or teach this to follow the pointer.
- *
- * Both lists name PROPERTIES only. A record's values and an array's elements can
- * be null too, but no port drops one: the pruning ports prune at `optional`
- * paths, which a `*` position can never be, and `JSONEncoder` drops a nil only
- * from a struct property — a nil inside a dictionary or array encodes as null.
- * Listing a `*` leaf would also make Swift's restore INVENT record keys that
- * were never there, which is why the walk records the path it descends through
- * but never the `*` position itself.
- */
-interface ModelNullPaths {
-  /** Required properties that permit null — a null there is a VALUE and must survive. */
-  nullable: ReadonlyArray<SchemaPath>;
-  /** Properties absent from their object's `required` — a null there means UNSET. */
-  optional: ReadonlyArray<SchemaPath>;
-}
-/** What a target renders from. */
-interface SdkRenderInput {
-  /**
-   * The rendered model source, to be written as the target's model file.
-   *
-   * Empty for a target that emits its own model FILES via
-   * {@link SdkTarget.renderModels} — those are already written, and this string
-   * exists only so the declared-model reconciliation reads one shape.
-   */
-  models: string;
-  /** Namespaces and their functions, already sorted. */
-  namespaces: ReadonlyArray<SdkNamespace>;
-}
-/**
- * One directory or file of the hand-written transport, and where it lands in the
- * output.
- *
- * `from` is relative to `sdks/<target id>/` and `to` is relative to `--out`. The
- * two differ because a repo layout and a consumable layout are not the same
- * shape: the Ruby transport lives under `lib/` so `ruby -Ilib` works in the
- * repo, while a vendored copy has no `lib` to point at, and the Rust transport
- * is the repo's root crate but a nested one in the output.
- *
- * Only the runtime is listed. A transport's own conformance suite and its
- * `generated_check/` sample are deliberately absent — they assert against
- * `protocol/fixtures/`, which is not copied, so vendoring them would ship a user
- * a test suite that cannot run.
- */
-interface SdkVendorEntry {
-  /** Path under `sdks/<id>/`. A directory is copied recursively. */
-  from: string;
-  /** Destination path under `--out`. */
-  to: string;
-}
-/** A language target. One per `--lang` value. */
-interface SdkTarget {
-  /** The `--lang` value (`"python"`, `"go"`, …). */
-  id: string;
-  /**
-   * The quicktype backend + renderer options that produce this target's
-   * models, or absent when the target emits its own (see
-   * {@link SdkTarget.renderModels}) or none at all.
-   *
-   * `LanguageName` is quicktype's own union, so a target naming a backend
-   * quicktype does not ship fails to compile rather than at run time.
-   */
-  quicktype?: {
-    lang: LanguageName;
-    rendererOptions?: Record<string, string>;
-  };
-  /**
-   * Render the SDK. Returns file contents keyed by path relative to the
-   * output directory (nested paths are created as needed).
-   *
-   * This includes the BUILD MANIFEST the layout needs — `go.mod`, `Cargo.toml`,
-   * `Package.swift`, a crate root — because those name the vendored transport
-   * and are therefore part of "how this language resolves the copy", not
-   * something a consumer should have to write. Languages that resolve by
-   * directory (Python, Ruby, Java, Kotlin) emit no manifest.
-   */
-  render: (input: SdkRenderInput) => Record<string, string>;
-  /**
-   * Emit this target's models from the schema directly, INSTEAD of quicktype,
-   * as file contents keyed by path relative to the output directory.
-   *
-   * Present only for the two JVM targets, and the exception is earned rather
-   * than a preference: quicktype's Java and Kotlin backends rename properties
-   * and, under `just-types`, emit no mapping metadata, so a model they render
-   * cannot be projected back onto the wire — and the only complete mapping
-   * they offer requires a Jackson / Klaxon / kotlinx dependency, which is the
-   * one thing these JDK-only transports are defined not to have.
-   * `targets/java.ts` records every option that was measured.
-   *
-   * A MAP rather than the single string quicktype returns, because Java takes
-   * one file per class: its single-file render is not compilable Java at all.
-   * The values are still joined for {@link SdkRenderInput.models}, so the
-   * declared-model reconciliation is the same code for every target.
-   */
-  renderModels?: (document: OpenRpcDocument) => Record<string, string>;
-  /**
-   * THIRD-PARTY packages a consuming project must still install, reported by
-   * the CLI. Empty for six of the eight — the transport is vendored and those
-   * six reach the wire with only their standard library.
-   *
-   * A list, and not derivable from the transport, because a target's MODELS can
-   * carry a dependency the transport does not: quicktype's Ruby backend emits
-   * `Dry::Struct` types with no renderer option to avoid them, so a Ruby SDK
-   * needs the gems even though `sdks/ruby` itself is dependency-free.
-   */
-  requires: ReadonlyArray<string>;
-  /**
-   * Which parts of `sdks/<id>/` are the transport, and where they land under
-   * `--out`. See {@link SdkVendorEntry}.
-   */
-  vendor: ReadonlyArray<SdkVendorEntry>;
-}
-/** Every language `lunora sdk generate --lang` accepts, keyed by id. */
-declare const SDK_TARGETS: Readonly<Record<string, SdkTarget>>;
-/** The accepted `--lang` values, sorted — for help text and error messages. */
-declare const SDK_LANGUAGES: ReadonlyArray<string>;
-/** The files a generation run writes, keyed by path relative to the output directory. */
-type SdkFiles = Record<string, string>;
-/** What a generation run produced, plus what it had to weaken and why. */
-interface SdkResult {
-  files: SdkFiles;
-  /**
-   * Model names predicted from the schema that the chosen backend did not
-   * declare, so their call sites fell back to an untyped return. Surfaced
-   * rather than swallowed — silently weaker types are how an SDK looks
-   * finished while returning `Any` everywhere.
-   */
-  undeclared: ReadonlyArray<string>;
-  /**
-   * Functions whose args or result carry a `v.bigint()` or `v.bytes()`. No
-   * typed model can represent those — the wire needs a tagged value that no
-   * generated field produces — so their parameters stay untyped and the
-   * caller passes wire values directly.
-   */
-  unrepresentable: ReadonlyArray<string>;
-}
-/**
- * Generate the SDK for `document` in `target`'s language.
- *
- * Async only because the model layer is: quicktype's renderer is promise-based.
- * The surface itself is pure, so a target's `render` stays synchronous and
- * unit-testable without touching quicktype.
- *
- * Models are rendered BEFORE the surface because the surface's model references
- * depend on what the backend actually declared — see {@link withDeclaredModels}.
- */
-declare const generateSdk: (document: OpenRpcDocument, target: SdkTarget) => Promise<SdkResult>;
 /** The matching secret rule's `kind` for a string value, or `undefined` when none matches. */
 declare const secretKindOf: (value: string) => string | undefined;
 /** A redacted preview of a secret value — first 4 chars plus its length, never the full value. */
 declare const redact: (value: string) => string;
 declare const VERSION = "0.0.0";
-export { AGENTS_FILENAME, type AgentIR, type ArchitectureManifest, type AuthApiCallIR, CAPABILITY_PROBES, CONTAINERS_FILENAME, type CapabilityKey, type CapabilityProbe, CodegenDiagnosticError, type CodegenOptions, type CodegenResult, type ContainerIR, type ContainerImageIR, type ContainerNamedImageIR, type ContextPropertyCallIR, type CronJobIR, DEFAULT_TARGET, type DefaultScheduledContainerIR, type DriftChange, type DriftRemediation, type DriftScope, type DurableObjectScheduledContainerIR, type EmitAppOptions, FLAGS_FILENAME, type FieldSnapshot, type FlagsIR, type FunctionIR, GENERATED_HEADER, type HttpRouteIR, type IndexIR, type IndexSnapshot, type InsertWriteIR, LUNORA_ERROR_CODES, type LintSchemaOptions, type LoadedProjectConfig, type LunoraProjectConfig, MUTATORS_FILENAME, type MaskProcedureIR, type MigrationIR, type MutatorIR, NOTIFY_FILENAME, type NotifyChannels, OPENRPC_VERSION, type OpenApiEmitInput, type OpenRpcDocument, type OpenRpcEmitInput, type OpenRpcMethod, PROJECT_CONFIG_FILENAMES, type PlatformDiagnostic, type ProjectConfigLiterals, type ProjectIR, QUEUES_FILENAME, type QueryReadIR, type QueueIR, type RelationSnapshot, type RlsMetadataIR, type RlsPolicyIR, type RlsProcedureIR, type RlsRoleIR, type RuntimeVerb, SCHEMA_SNAPSHOT_FILENAME, SCHEMA_SNAPSHOT_VERSION, SDK_LANGUAGES, SDK_TARGETS, SHAPES_FILENAME, type SandboxUsage, type SchemaDrift, type SchemaDriftDecision, type SchemaIR, type SchemaSnapshot, SchemaSnapshotParseError, type SdkFiles, type SdkMethod, type SdkNamespace, type SdkRenderInput, type SdkResult, type SdkTarget, type ServiceBindingIR, type ServiceLiteral, type ShapeIR, type SourceCapabilitySignals, type StorageRuleIR, type StorageRulesMetadataIR, type TableIR, type TableSnapshot, type TopicIR, VERSION, type ValidatorIR, type VectorIndexIR, WORKFLOWS_FILENAME, type WorkflowIR, type WranglerQueueProducerIR, type WranglerVariableIR, buildOpenApiDocument, buildOpenRpcDocument, buildSchemaSnapshot, capabilitiesUsedBy, createCodegenProject, describeErrorLevelFindings, diagnosticAt, diffSchemaSnapshots, discoverAgents, discoverAuthApiCalls, discoverContainers, discoverCrons, discoverFlags, discoverFunctions, discoverHttpRoutes, discoverHyperdriveCalls, discoverInserts, discoverMaskProcedures, discoverMigrations, discoverMutators, discoverNondeterministicCalls, discoverNotifyCalls, discoverNotifyChannels, discoverNotifyConfig, discoverQueries, discoverQueues, discoverR2sqlCalls, discoverRlsMetadata, discoverRlsProcedures, discoverSandboxUsage, discoverSchema, discoverShapes, discoverStorageRulesMetadata, discoverWorkflows, emitAgents, emitApi, emitApp, emitCollections, emitContainers, emitCrons, emitDataModel, emitDrizzleSchema, emitFunctions, emitInternalApi, emitOpenApi, emitOpenApiModule, emitOpenRpc, emitOpenRpcModule, emitScheduler, emitServer, emitShard, emitVectors, emitWorkflows, emitWranglerCronTriggers, errorAdvisoryNames, errorPlatformDiagnosticNames, evaluateSchemaDrift, findProjectConfigFile, findTsconfig, fingerprintSchemaSources, foldCapabilitySignals, formatAdvisories, generateSdk, isD1GlobalTable, isHyperdriveGlobalTable, isTestPath, isTypedSchema, lintSchema, listLunoraSourceFiles, loadProjectConfig, mayReadCapabilityContext, parseSchemaSnapshot, platformMatrixIds, readPackageDependencies, readProjectConfigLiterals, readProjectTarget, readServiceBindings, redact, refreshCodegenProject, resolveCodegenTarget, resolveServiceBindings, runCodegen, schemaFromIr, secretKindOf, serializeSchemaSnapshot, sortedUniqueNames, sourceCapabilitySignals, toAdvisorContext, validatorIrToJsonSchema };
+export { AGENTS_FILENAME, type AgentIR, type ArchitectureManifest, type AuthApiCallIR, CAPABILITY_PROBES, CONTAINERS_FILENAME, type CapabilityKey, type CapabilityProbe, CodegenDiagnosticError, type CodegenOptions, type CodegenResult, type ContainerIR, type ContainerImageIR, type ContainerNamedImageIR, type ContextPropertyCallIR, type CronJobIR, DEFAULT_TARGET, type DefaultScheduledContainerIR, type DriftChange, type DriftRemediation, type DriftScope, type DurableObjectScheduledContainerIR, type EmitAppOptions, FLAGS_FILENAME, type FieldSnapshot, type FlagsIR, type FunctionIR, GENERATED_HEADER, type HttpRouteIR, type IndexIR, type IndexSnapshot, type InsertWriteIR, LUNORA_ERROR_CODES, type LintSchemaOptions, type LoadedProjectConfig, type LunoraProjectConfig, MUTATORS_FILENAME, type MaskProcedureIR, type MigrationIR, type MutatorIR, NOTIFY_FILENAME, type NotifyChannels, OPENRPC_VERSION, type OpenApiEmitInput, type OpenRpcEmitInput, PROJECT_CONFIG_FILENAMES, type PlatformDiagnostic, type ProjectConfigLiterals, type ProjectIR, QUEUES_FILENAME, type QueryReadIR, type QueueIR, type RelationSnapshot, type RlsMetadataIR, type RlsPolicyIR, type RlsProcedureIR, type RlsRoleIR, SCHEMA_SNAPSHOT_FILENAME, SCHEMA_SNAPSHOT_VERSION, SHAPES_FILENAME, type SandboxUsage, type SchemaDrift, type SchemaDriftDecision, type SchemaIR, type SchemaSnapshot, SchemaSnapshotParseError, type ServiceBindingIR, type ServiceLiteral, type ShapeIR, type SourceCapabilitySignals, type StorageRuleIR, type StorageRulesMetadataIR, type TableIR, type TableSnapshot, type TopicIR, VERSION, type ValidatorIR, type VectorIndexIR, WORKFLOWS_FILENAME, type WorkflowIR, type WranglerQueueProducerIR, type WranglerVariableIR, buildOpenApiDocument, buildOpenRpcDocument, buildSchemaSnapshot, capabilitiesUsedBy, createCodegenProject, describeErrorLevelFindings, diagnosticAt, diffSchemaSnapshots, discoverAgents, discoverAuthApiCalls, discoverContainers, discoverCrons, discoverFlags, discoverFunctions, discoverHttpRoutes, discoverHyperdriveCalls, discoverInserts, discoverMaskProcedures, discoverMigrations, discoverMutators, discoverNondeterministicCalls, discoverNotifyCalls, discoverNotifyChannels, discoverNotifyConfig, discoverQueries, discoverQueues, discoverR2sqlCalls, discoverRlsMetadata, discoverRlsProcedures, discoverSandboxUsage, discoverSchema, discoverShapes, discoverStorageRulesMetadata, discoverWorkflows, emitAgents, emitApi, emitApp, emitCollections, emitContainers, emitCrons, emitDataModel, emitDrizzleSchema, emitFunctions, emitInternalApi, emitOpenApi, emitOpenApiModule, emitOpenRpc, emitOpenRpcModule, emitScheduler, emitServer, emitShard, emitVectors, emitWorkflows, emitWranglerCronTriggers, errorAdvisoryNames, errorPlatformDiagnosticNames, evaluateSchemaDrift, findProjectConfigFile, findTsconfig, fingerprintSchemaSources, foldCapabilitySignals, formatAdvisories, isD1GlobalTable, isHyperdriveGlobalTable, isTestPath, lintSchema, listLunoraSourceFiles, loadProjectConfig, mayReadCapabilityContext, parseSchemaSnapshot, platformMatrixIds, readPackageDependencies, readProjectConfigLiterals, readProjectTarget, readServiceBindings, redact, refreshCodegenProject, resolveCodegenTarget, resolveServiceBindings, runCodegen, schemaFromIr, secretKindOf, serializeSchemaSnapshot, sortedUniqueNames, sourceCapabilitySignals, toAdvisorContext, validatorIrToJsonSchema };

package/dist/index.d.ts

@@ -5,8 +5,9 @@ import { LunoraError } from '@lunora/errors';
 export { MESSAGE_SOLUTIONS as LUNORA_SOLUTION_RULES, type Solution as LunoraSolution, type SolutionRule as LunoraSolutionRule, findSolutionByMessage as findLunoraSolution } from '@lunora/errors';
 import { Schema } from '@lunora/server';
 import { JsonSchema } from '@lunora/values';
-import { LanguageName } from 'quicktype-core';
+export { type OpenRpcDocument, type OpenRpcMethod, type RuntimeVerb, SDK_LANGUAGES, SDK_TARGETS, type SdkFiles, type SdkMethod, type SdkNamespace, type SdkRenderInput, type SdkResult, type SdkTarget, generateSdk, isTypedSchema } from "./sdk/index.js";
 import { StudioFeaturesResult } from '@lunora/shard-engine';
+import 'quicktype-core';
 /**
  * The architecture manifest — `_generated/architecture.json` — shared by the
  * codegen that builds it, the runtime that serves it at
@@ -4604,295 +4605,9 @@ declare const validatorIrToJsonSchema: (validator: ValidatorIR) => JsonSchema;
  * the contract; clients switch on `error.code`. Kept sorted for stable output.
  */
 declare const LUNORA_ERROR_CODES: ReadonlyArray<string>;
-/**
- * Language-agnostic half of SDK generation: turn an OpenRPC document
- * (`_generated/openrpc.json`, see {@link file://../openrpc.ts}) into the parsed
- * shape every per-language target renders from.
- *
- * Nothing here knows about a target language. A target supplies its own member
- * naming and templates (see {@link file://./targets}); everything that would
- * otherwise be re-derived per language — how a `functionPath` splits, which
- * runtime verb a kind maps to, whether a schema is real or the untyped
- * placeholder, how namespaces group and sort — lives here exactly once.
- *
- * That single-source rule is not stylistic. `paths.ts` documents the same
- * discipline for namespaces ("if these ever disagree, runtime dispatch silently
- * misses functions"), and the failure mode here is the same in a new costume: a
- * target that re-derives a model name renders an import pointing at a class
- * quicktype never emitted.
- *
- * Deriving names in one place is necessary but NOT sufficient, because only
- * half the decision is ours: quicktype chooses whether a predicted name becomes
- * a declared type, and different backends answer differently for the same
- * schema. {@link withDeclaredModels} reconciles the two halves before a target
- * renders anything.
- */
-/** One OpenRPC method as {@link file://../openrpc.ts} emits it. */
-interface OpenRpcMethod {
-  name: string;
-  params?: ReadonlyArray<{
-    name: string;
-    schema?: Record<string, unknown>;
-  }>;
-  result?: {
-    name: string;
-    schema?: Record<string, unknown>;
-  };
-  summary?: string;
-  "x-lunora-function-kind"?: string;
-}
-/** The `_generated/openrpc.json` document. */
-interface OpenRpcDocument {
-  info?: {
-    title?: string;
-    version?: string;
-  };
-  methods: ReadonlyArray<OpenRpcMethod>;
-}
-/** The runtime verbs a generated SDK can call. Mirrors the client transports. */
-type RuntimeVerb = "action" | "mutation" | "query";
-/** One RPC function, parsed and language-neutral. */
-interface SdkMethod {
-  /**
-   * Where this function's ARGUMENT nulls mean "unset" and where they mean
-   * "null" — see {@link ModelNullPaths}.
-   *
-   * On the method rather than on a shared render input because it is a
-   * per-method fact and the parser already holds the schema it comes from. Read
-   * by the three targets whose rendered models cannot tell the two apart
-   * (ruby, rust, swift); the other five have a marker of their own and ignore
-   * it.
-   */
-  argsNullPaths: ModelNullPaths;
-  /**
-   * Generated args model name, or `undefined` when NO model could be named for
-   * this function's arguments.
-   *
-   * `undefined` does NOT mean "takes no arguments" — see {@link SdkMethod.takesArgs}.
-   * A schema carrying a `v.bigint()` or `v.bytes()` gets no model deliberately
-   * (`hasUnrepresentableWireType`), and a backend that cannot name a shape leaves
-   * it undeclared. Both still take arguments, just untyped ones.
-   */
-  argsType: string | undefined;
-  /** Raw exported function name (`"list"`), before any naming convention. */
-  functionName: string;
-  /** The wire identifier (`"messages:list"`), emitted verbatim into calls. */
-  functionPath: string;
-  /** Raw file namespace (`"messages"`), before any naming convention. */
-  namespace: string;
-  /** Generated result model name, or `undefined` while the result is untyped. */
-  resultType: string | undefined;
-  /** Human summary for the doc comment. */
-  summary: string;
-  /**
-   * Whether this function declares arguments at all, independent of whether a
-   * model could be named for them.
-   *
-   * A target emits three shapes from this: a TYPED parameter when `argsType` is
-   * set, an UNTYPED wire-shaped parameter when it is not but this is true, and no
-   * parameter at all when this is false. Collapsing the middle case into the last
-   * is what made `v.bigint()` functions uncallable with arguments.
-   */
-  takesArgs: boolean;
-  /** Which runtime verb this dispatches to. */
-  verb: RuntimeVerb;
-}
-/** One namespace's functions, sorted. */
-interface SdkNamespace {
-  methods: ReadonlyArray<SdkMethod>;
-  /** Raw namespace (`"messages"`); a target applies its own casing. */
-  name: string;
-}
-/**
- * True when a schema actually describes a shape.
- *
- * `openrpc.ts` emits a description-only placeholder for any function without a
- * declared `.output()` (the return type is TS-inferred and absent from the IR).
- * A placeholder must never become a generated model: quicktype would render an
- * empty type, and the surface would decode every response into it — silently
- * discarding the real payload rather than leaving it untyped.
- */
-declare const isTypedSchema: (schema: Record<string, unknown> | undefined) => boolean;
-/**
- * A path from a model's root to one property. `*` stands for every element of an
- * array or every value of a record, neither of which has named positions.
- */
-type SchemaPath = ReadonlyArray<string>;
-/**
- * Where a model's nulls mean different things — the one fact a generated model
- * flattens away, and the reason three ports could not send a `v.nullable()`
- * argument at all.
- *
- * An unset `v.optional()` and a `v.nullable()` set to null are the SAME value in
- * every generated model (a nil field), and opposite things on the wire: the
- * validator rejects an explicit null for the first and requires the key present
- * for the second. Neither Ruby, Rust nor Swift renders a marker telling them
- * apart, so the distinction is computed here, from the schema, where `required`
- * still exists — and handed to the targets that need it.
- *
- * Two lists rather than one because the ports need opposite operations. Ruby and
- * Rust project a whole value tree and prune nulls, so they prune at
- * {@link ModelNullPaths.optional} and nowhere else — which also stops them
- * dropping a legitimate null inside a record or an array, as a blanket prune
- * does. Swift's `JSONEncoder` has already dropped every struct-property nil
- * before the transport sees a tree, so it restores nulls at
- * {@link ModelNullPaths.nullable} instead: an absent key at a required path can
- * only have been a nil, so putting the null back is exact.
- *
- * A `$ref` is NOT resolved. `openrpc.ts` inlines everything it emits, so this
- * never comes up for a generated document — but `--spec` accepts a hand-written
- * one, and there a `$ref`'d sub-object contributes no paths at all: the ports
- * that prune would send its unset optionals as null, and Swift would not restore
- * its nullables. Inline the schema, or teach this to follow the pointer.
- *
- * Both lists name PROPERTIES only. A record's values and an array's elements can
- * be null too, but no port drops one: the pruning ports prune at `optional`
- * paths, which a `*` position can never be, and `JSONEncoder` drops a nil only
- * from a struct property — a nil inside a dictionary or array encodes as null.
- * Listing a `*` leaf would also make Swift's restore INVENT record keys that
- * were never there, which is why the walk records the path it descends through
- * but never the `*` position itself.
- */
-interface ModelNullPaths {
-  /** Required properties that permit null — a null there is a VALUE and must survive. */
-  nullable: ReadonlyArray<SchemaPath>;
-  /** Properties absent from their object's `required` — a null there means UNSET. */
-  optional: ReadonlyArray<SchemaPath>;
-}
-/** What a target renders from. */
-interface SdkRenderInput {
-  /**
-   * The rendered model source, to be written as the target's model file.
-   *
-   * Empty for a target that emits its own model FILES via
-   * {@link SdkTarget.renderModels} — those are already written, and this string
-   * exists only so the declared-model reconciliation reads one shape.
-   */
-  models: string;
-  /** Namespaces and their functions, already sorted. */
-  namespaces: ReadonlyArray<SdkNamespace>;
-}
-/**
- * One directory or file of the hand-written transport, and where it lands in the
- * output.
- *
- * `from` is relative to `sdks/<target id>/` and `to` is relative to `--out`. The
- * two differ because a repo layout and a consumable layout are not the same
- * shape: the Ruby transport lives under `lib/` so `ruby -Ilib` works in the
- * repo, while a vendored copy has no `lib` to point at, and the Rust transport
- * is the repo's root crate but a nested one in the output.
- *
- * Only the runtime is listed. A transport's own conformance suite and its
- * `generated_check/` sample are deliberately absent — they assert against
- * `protocol/fixtures/`, which is not copied, so vendoring them would ship a user
- * a test suite that cannot run.
- */
-interface SdkVendorEntry {
-  /** Path under `sdks/<id>/`. A directory is copied recursively. */
-  from: string;
-  /** Destination path under `--out`. */
-  to: string;
-}
-/** A language target. One per `--lang` value. */
-interface SdkTarget {
-  /** The `--lang` value (`"python"`, `"go"`, …). */
-  id: string;
-  /**
-   * The quicktype backend + renderer options that produce this target's
-   * models, or absent when the target emits its own (see
-   * {@link SdkTarget.renderModels}) or none at all.
-   *
-   * `LanguageName` is quicktype's own union, so a target naming a backend
-   * quicktype does not ship fails to compile rather than at run time.
-   */
-  quicktype?: {
-    lang: LanguageName;
-    rendererOptions?: Record<string, string>;
-  };
-  /**
-   * Render the SDK. Returns file contents keyed by path relative to the
-   * output directory (nested paths are created as needed).
-   *
-   * This includes the BUILD MANIFEST the layout needs — `go.mod`, `Cargo.toml`,
-   * `Package.swift`, a crate root — because those name the vendored transport
-   * and are therefore part of "how this language resolves the copy", not
-   * something a consumer should have to write. Languages that resolve by
-   * directory (Python, Ruby, Java, Kotlin) emit no manifest.
-   */
-  render: (input: SdkRenderInput) => Record<string, string>;
-  /**
-   * Emit this target's models from the schema directly, INSTEAD of quicktype,
-   * as file contents keyed by path relative to the output directory.
-   *
-   * Present only for the two JVM targets, and the exception is earned rather
-   * than a preference: quicktype's Java and Kotlin backends rename properties
-   * and, under `just-types`, emit no mapping metadata, so a model they render
-   * cannot be projected back onto the wire — and the only complete mapping
-   * they offer requires a Jackson / Klaxon / kotlinx dependency, which is the
-   * one thing these JDK-only transports are defined not to have.
-   * `targets/java.ts` records every option that was measured.
-   *
-   * A MAP rather than the single string quicktype returns, because Java takes
-   * one file per class: its single-file render is not compilable Java at all.
-   * The values are still joined for {@link SdkRenderInput.models}, so the
-   * declared-model reconciliation is the same code for every target.
-   */
-  renderModels?: (document: OpenRpcDocument) => Record<string, string>;
-  /**
-   * THIRD-PARTY packages a consuming project must still install, reported by
-   * the CLI. Empty for six of the eight — the transport is vendored and those
-   * six reach the wire with only their standard library.
-   *
-   * A list, and not derivable from the transport, because a target's MODELS can
-   * carry a dependency the transport does not: quicktype's Ruby backend emits
-   * `Dry::Struct` types with no renderer option to avoid them, so a Ruby SDK
-   * needs the gems even though `sdks/ruby` itself is dependency-free.
-   */
-  requires: ReadonlyArray<string>;
-  /**
-   * Which parts of `sdks/<id>/` are the transport, and where they land under
-   * `--out`. See {@link SdkVendorEntry}.
-   */
-  vendor: ReadonlyArray<SdkVendorEntry>;
-}
-/** Every language `lunora sdk generate --lang` accepts, keyed by id. */
-declare const SDK_TARGETS: Readonly<Record<string, SdkTarget>>;
-/** The accepted `--lang` values, sorted — for help text and error messages. */
-declare const SDK_LANGUAGES: ReadonlyArray<string>;
-/** The files a generation run writes, keyed by path relative to the output directory. */
-type SdkFiles = Record<string, string>;
-/** What a generation run produced, plus what it had to weaken and why. */
-interface SdkResult {
-  files: SdkFiles;
-  /**
-   * Model names predicted from the schema that the chosen backend did not
-   * declare, so their call sites fell back to an untyped return. Surfaced
-   * rather than swallowed — silently weaker types are how an SDK looks
-   * finished while returning `Any` everywhere.
-   */
-  undeclared: ReadonlyArray<string>;
-  /**
-   * Functions whose args or result carry a `v.bigint()` or `v.bytes()`. No
-   * typed model can represent those — the wire needs a tagged value that no
-   * generated field produces — so their parameters stay untyped and the
-   * caller passes wire values directly.
-   */
-  unrepresentable: ReadonlyArray<string>;
-}
-/**
- * Generate the SDK for `document` in `target`'s language.
- *
- * Async only because the model layer is: quicktype's renderer is promise-based.
- * The surface itself is pure, so a target's `render` stays synchronous and
- * unit-testable without touching quicktype.
- *
- * Models are rendered BEFORE the surface because the surface's model references
- * depend on what the backend actually declared — see {@link withDeclaredModels}.
- */
-declare const generateSdk: (document: OpenRpcDocument, target: SdkTarget) => Promise<SdkResult>;
 /** The matching secret rule's `kind` for a string value, or `undefined` when none matches. */
 declare const secretKindOf: (value: string) => string | undefined;
 /** A redacted preview of a secret value — first 4 chars plus its length, never the full value. */
 declare const redact: (value: string) => string;
 declare const VERSION = "0.0.0";
-export { AGENTS_FILENAME, type AgentIR, type ArchitectureManifest, type AuthApiCallIR, CAPABILITY_PROBES, CONTAINERS_FILENAME, type CapabilityKey, type CapabilityProbe, CodegenDiagnosticError, type CodegenOptions, type CodegenResult, type ContainerIR, type ContainerImageIR, type ContainerNamedImageIR, type ContextPropertyCallIR, type CronJobIR, DEFAULT_TARGET, type DefaultScheduledContainerIR, type DriftChange, type DriftRemediation, type DriftScope, type DurableObjectScheduledContainerIR, type EmitAppOptions, FLAGS_FILENAME, type FieldSnapshot, type FlagsIR, type FunctionIR, GENERATED_HEADER, type HttpRouteIR, type IndexIR, type IndexSnapshot, type InsertWriteIR, LUNORA_ERROR_CODES, type LintSchemaOptions, type LoadedProjectConfig, type LunoraProjectConfig, MUTATORS_FILENAME, type MaskProcedureIR, type MigrationIR, type MutatorIR, NOTIFY_FILENAME, type NotifyChannels, OPENRPC_VERSION, type OpenApiEmitInput, type OpenRpcDocument, type OpenRpcEmitInput, type OpenRpcMethod, PROJECT_CONFIG_FILENAMES, type PlatformDiagnostic, type ProjectConfigLiterals, type ProjectIR, QUEUES_FILENAME, type QueryReadIR, type QueueIR, type RelationSnapshot, type RlsMetadataIR, type RlsPolicyIR, type RlsProcedureIR, type RlsRoleIR, type RuntimeVerb, SCHEMA_SNAPSHOT_FILENAME, SCHEMA_SNAPSHOT_VERSION, SDK_LANGUAGES, SDK_TARGETS, SHAPES_FILENAME, type SandboxUsage, type SchemaDrift, type SchemaDriftDecision, type SchemaIR, type SchemaSnapshot, SchemaSnapshotParseError, type SdkFiles, type SdkMethod, type SdkNamespace, type SdkRenderInput, type SdkResult, type SdkTarget, type ServiceBindingIR, type ServiceLiteral, type ShapeIR, type SourceCapabilitySignals, type StorageRuleIR, type StorageRulesMetadataIR, type TableIR, type TableSnapshot, type TopicIR, VERSION, type ValidatorIR, type VectorIndexIR, WORKFLOWS_FILENAME, type WorkflowIR, type WranglerQueueProducerIR, type WranglerVariableIR, buildOpenApiDocument, buildOpenRpcDocument, buildSchemaSnapshot, capabilitiesUsedBy, createCodegenProject, describeErrorLevelFindings, diagnosticAt, diffSchemaSnapshots, discoverAgents, discoverAuthApiCalls, discoverContainers, discoverCrons, discoverFlags, discoverFunctions, discoverHttpRoutes, discoverHyperdriveCalls, discoverInserts, discoverMaskProcedures, discoverMigrations, discoverMutators, discoverNondeterministicCalls, discoverNotifyCalls, discoverNotifyChannels, discoverNotifyConfig, discoverQueries, discoverQueues, discoverR2sqlCalls, discoverRlsMetadata, discoverRlsProcedures, discoverSandboxUsage, discoverSchema, discoverShapes, discoverStorageRulesMetadata, discoverWorkflows, emitAgents, emitApi, emitApp, emitCollections, emitContainers, emitCrons, emitDataModel, emitDrizzleSchema, emitFunctions, emitInternalApi, emitOpenApi, emitOpenApiModule, emitOpenRpc, emitOpenRpcModule, emitScheduler, emitServer, emitShard, emitVectors, emitWorkflows, emitWranglerCronTriggers, errorAdvisoryNames, errorPlatformDiagnosticNames, evaluateSchemaDrift, findProjectConfigFile, findTsconfig, fingerprintSchemaSources, foldCapabilitySignals, formatAdvisories, generateSdk, isD1GlobalTable, isHyperdriveGlobalTable, isTestPath, isTypedSchema, lintSchema, listLunoraSourceFiles, loadProjectConfig, mayReadCapabilityContext, parseSchemaSnapshot, platformMatrixIds, readPackageDependencies, readProjectConfigLiterals, readProjectTarget, readServiceBindings, redact, refreshCodegenProject, resolveCodegenTarget, resolveServiceBindings, runCodegen, schemaFromIr, secretKindOf, serializeSchemaSnapshot, sortedUniqueNames, sourceCapabilitySignals, toAdvisorContext, validatorIrToJsonSchema };
+export { AGENTS_FILENAME, type AgentIR, type ArchitectureManifest, type AuthApiCallIR, CAPABILITY_PROBES, CONTAINERS_FILENAME, type CapabilityKey, type CapabilityProbe, CodegenDiagnosticError, type CodegenOptions, type CodegenResult, type ContainerIR, type ContainerImageIR, type ContainerNamedImageIR, type ContextPropertyCallIR, type CronJobIR, DEFAULT_TARGET, type DefaultScheduledContainerIR, type DriftChange, type DriftRemediation, type DriftScope, type DurableObjectScheduledContainerIR, type EmitAppOptions, FLAGS_FILENAME, type FieldSnapshot, type FlagsIR, type FunctionIR, GENERATED_HEADER, type HttpRouteIR, type IndexIR, type IndexSnapshot, type InsertWriteIR, LUNORA_ERROR_CODES, type LintSchemaOptions, type LoadedProjectConfig, type LunoraProjectConfig, MUTATORS_FILENAME, type MaskProcedureIR, type MigrationIR, type MutatorIR, NOTIFY_FILENAME, type NotifyChannels, OPENRPC_VERSION, type OpenApiEmitInput, type OpenRpcEmitInput, PROJECT_CONFIG_FILENAMES, type PlatformDiagnostic, type ProjectConfigLiterals, type ProjectIR, QUEUES_FILENAME, type QueryReadIR, type QueueIR, type RelationSnapshot, type RlsMetadataIR, type RlsPolicyIR, type RlsProcedureIR, type RlsRoleIR, SCHEMA_SNAPSHOT_FILENAME, SCHEMA_SNAPSHOT_VERSION, SHAPES_FILENAME, type SandboxUsage, type SchemaDrift, type SchemaDriftDecision, type SchemaIR, type SchemaSnapshot, SchemaSnapshotParseError, type ServiceBindingIR, type ServiceLiteral, type ShapeIR, type SourceCapabilitySignals, type StorageRuleIR, type StorageRulesMetadataIR, type TableIR, type TableSnapshot, type TopicIR, VERSION, type ValidatorIR, type VectorIndexIR, WORKFLOWS_FILENAME, type WorkflowIR, type WranglerQueueProducerIR, type WranglerVariableIR, buildOpenApiDocument, buildOpenRpcDocument, buildSchemaSnapshot, capabilitiesUsedBy, createCodegenProject, describeErrorLevelFindings, diagnosticAt, diffSchemaSnapshots, discoverAgents, discoverAuthApiCalls, discoverContainers, discoverCrons, discoverFlags, discoverFunctions, discoverHttpRoutes, discoverHyperdriveCalls, discoverInserts, discoverMaskProcedures, discoverMigrations, discoverMutators, discoverNondeterministicCalls, discoverNotifyCalls, discoverNotifyChannels, discoverNotifyConfig, discoverQueries, discoverQueues, discoverR2sqlCalls, discoverRlsMetadata, discoverRlsProcedures, discoverSandboxUsage, discoverSchema, discoverShapes, discoverStorageRulesMetadata, discoverWorkflows, emitAgents, emitApi, emitApp, emitCollections, emitContainers, emitCrons, emitDataModel, emitDrizzleSchema, emitFunctions, emitInternalApi, emitOpenApi, emitOpenApiModule, emitOpenRpc, emitOpenRpcModule, emitScheduler, emitServer, emitShard, emitVectors, emitWorkflows, emitWranglerCronTriggers, errorAdvisoryNames, errorPlatformDiagnosticNames, evaluateSchemaDrift, findProjectConfigFile, findTsconfig, fingerprintSchemaSources, foldCapabilitySignals, formatAdvisories, isD1GlobalTable, isHyperdriveGlobalTable, isTestPath, lintSchema, listLunoraSourceFiles, loadProjectConfig, mayReadCapabilityContext, parseSchemaSnapshot, platformMatrixIds, readPackageDependencies, readProjectConfigLiterals, readProjectTarget, readServiceBindings, redact, refreshCodegenProject, resolveCodegenTarget, resolveServiceBindings, runCodegen, schemaFromIr, secretKindOf, serializeSchemaSnapshot, sortedUniqueNames, sourceCapabilitySignals, toAdvisorContext, validatorIrToJsonSchema };

package/dist/index.mjs

@@ -1 +1 @@
-import{SCHEMA_SNAPSHOT_VERSION as t,diffSchemaSnapshots as s,serializeSchemaSnapshot as a}from"./packem_shared/SCHEMA_SNAPSHOT_VERSION-C0oHwiJZ.mjs";import{formatAdvisories as m,lintSchema as f,toAdvisorContext as d}from"./packem_shared/formatAdvisories-BCVASH7N.mjs";import{describeErrorLevelFindings as n,errorAdvisoryNames as l,errorPlatformDiagnosticNames as c,sortedUniqueNames as x}from"./packem_shared/describeErrorLevelFindings-vzaGS9KL.mjs";import{CAPABILITY_PROBES as E}from"./packem_shared/CAPABILITY_PROBES-brcmKenl.mjs";import{CodegenDiagnosticError as A,diagnosticAt as v}from"./packem_shared/CodegenDiagnosticError-BUXlG3P-.mjs";import{AGENTS_FILENAME as N,discoverAgents as g}from"./packem_shared/AGENTS_FILENAME-B6-kjzM3.mjs";import{isTestPath as R,listLunoraSourceFiles as T}from"./packem_shared/isTestPath-B81lOULB.mjs";import{default as I}from"./packem_shared/discoverAuthApiCalls-xs0ONfI-.mjs";import{CONTAINERS_FILENAME as L,discoverContainers as M}from"./packem_shared/CONTAINERS_FILENAME-dFRtAyIe.mjs";import{default as P}from"./packem_shared/discoverCrons-DBnCama4.mjs";import{capabilitiesUsedBy as b,foldCapabilitySignals as y,mayReadCapabilityContext as U,sourceCapabilitySignals as G}from"./packem_shared/capabilitiesUsedBy-QgSZyE0T.mjs";import{FLAGS_FILENAME as j,discoverFlags as B}from"./packem_shared/FLAGS_FILENAME-Bf0MSlHH.mjs";import{default as W}from"./packem_shared/discoverFunctions-CbxZGGj0.mjs";import{default as V}from"./packem_shared/discoverHttpRoutes-DgfoyNcf.mjs";import{default as Q}from"./packem_shared/discoverHyperdriveCalls-CwnXgjFJ.mjs";import{default as w}from"./packem_shared/discoverInserts-mHOX_dJR.mjs";import{d as Y}from"./packem_shared/index-CkS96b8a.mjs";import{default as Z}from"./packem_shared/discoverMigrations-C9mLIhGZ.mjs";import{MUTATORS_FILENAME as ee,discoverMutators as re}from"./packem_shared/MUTATORS_FILENAME-qVDmv8st.mjs";import{default as te}from"./packem_shared/discoverNondeterministicCalls-9ZDpRptb.mjs";import{NOTIFY_FILENAME as ae,discoverNotifyCalls as ie,discoverNotifyChannels as me,discoverNotifyConfig as fe}from"./packem_shared/NOTIFY_FILENAME-CLoeWMb5.mjs";import{default as pe}from"./packem_shared/readPackageDependencies-RHhGiz0k.mjs";import{default as le}from"./packem_shared/discoverQueries-CfxkjP5X.mjs";import{QUEUES_FILENAME as xe,discoverQueues as Se}from"./packem_shared/QUEUES_FILENAME-CsRy4VTF.mjs";import{default as ue}from"./packem_shared/discoverR2sqlCalls-XBhs4XRZ.mjs";import{default as ve}from"./packem_shared/discoverRlsProcedures-TskedRMh.mjs";import{default as Ne}from"./packem_shared/discoverRlsMetadata-Cb8JR1b4.mjs";import{discoverSandboxUsage as Oe}from"./packem_shared/discoverSandboxUsage-w6Q3RvxZ.mjs";import{default as Te}from"./packem_shared/discoverSchema-BtsX-CN9.mjs";import{readServiceBindings as Ie,resolveServiceBindings as _e}from"./packem_shared/readServiceBindings-DvqIThzd.mjs";import{SHAPES_FILENAME as Me,discoverShapes as Fe}from"./packem_shared/SHAPES_FILENAME-DkBUN9dK.mjs";import{default as De}from"./packem_shared/discoverStorageRulesMetadata-BPJplDfz.mjs";import{WORKFLOWS_FILENAME as ye,discoverWorkflows as Ue}from"./packem_shared/WORKFLOWS_FILENAME-CdeS224T.mjs";import{emitApp as He}from"./packem_shared/emitApp-BOUdd-2R.mjs";import{isD1GlobalTable as Be,isHyperdriveGlobalTable as ke}from"./packem_shared/isD1GlobalTable-udvHAAzD.mjs";import{buildOpenApiDocument as Ke,emitOpenApi as Ve,emitOpenApiModule as ze}from"./packem_shared/buildOpenApiDocument-DFv-RYZU.mjs";import{OPENRPC_VERSION as qe,buildOpenRpcDocument as we,emitOpenRpc as Je,emitOpenRpcModule as Ye}from"./packem_shared/OPENRPC_VERSION-CCY7xqSL.mjs";import{DEFAULT_TARGET as Ze,platformMatrixIds as $e,readProjectTarget as er,resolveCodegenTarget as rr}from"./packem_shared/DEFAULT_TARGET-BnQiNNKu.mjs";import{l as tr,r as sr}from"./packem_shared/project-config-file-BV7RR-l6.mjs";import{SCHEMA_SNAPSHOT_FILENAME as ir,runCodegen as mr}from"./packem_shared/SCHEMA_SNAPSHOT_FILENAME-CSjCtmZi.mjs";import{SchemaSnapshotParseError as dr,buildSchemaSnapshot as pr,evaluateSchemaDrift as nr,parseSchemaSnapshot as lr}from"./packem_shared/SchemaSnapshotParseError-BRJT7c2k.mjs";import{default as xr}from"./packem_shared/fingerprintSchemaSources-eVG9aVt0.mjs";import{schemaFromIr as Er}from"./packem_shared/schemaFromIr-BWFnvCVg.mjs";import{LUNORA_ERROR_CODES as Ar,validatorIrToJsonSchema as vr}from"./packem_shared/LUNORA_ERROR_CODES-C2s0xWQD.mjs";import{SDK_LANGUAGES as Nr,SDK_TARGETS as gr,generateSdk as Or}from"./packem_shared/SDK_LANGUAGES-Df_CnJx5.mjs";import{redact as Tr,secretKindOf as hr}from"./packem_shared/redact-Cy14LEnc.mjs";import{default as _r}from"./packem_shared/emitDrizzleSchema-DitcRZ1a.mjs";import{default as Mr}from"./packem_shared/emitFunctions-BeKgL3dl.mjs";import{e as Pr}from"./packem_shared/server-DAvi_bv_.mjs";import{e as br}from"./packem_shared/shard-Av4rUyYS.mjs";import{G as Ur}from"./packem_shared/shared-DnCokNcE.mjs";import{MESSAGE_SOLUTIONS as Hr,findSolutionByMessage as jr}from"@lunora/errors";import{PROJECT_CONFIG_FILENAMES as kr,findProjectConfigFile as Wr}from"./packem_shared/PROJECT_CONFIG_FILENAMES-DzOu-lSc.mjs";import{createCodegenProject as Vr,findTsconfig as zr,refreshCodegenProject as Qr}from"./packem_shared/createCodegenProject-V51_yBw3.mjs";import{s as wr,t as Jr,u as Yr}from"./packem_shared/shard-runtime-CkTgY8tL.mjs";import{emitApi as Zr,emitCollections as $r,emitInternalApi as eo}from"./packem_shared/emitApi-Zx6VPN-7.mjs";import{emitCrons as oo,emitScheduler as to,emitVectors as so,emitWranglerCronTriggers as ao}from"./packem_shared/emitCrons-BQW2lviZ.mjs";import{emitDataModel as mo}from"./packem_shared/emitDataModel-BskFt9Wv.mjs";import{isTypedSchema as po}from"./packem_shared/isTypedSchema-CKzc3ioR.mjs";const e="0.0.0";export{N as AGENTS_FILENAME,E as CAPABILITY_PROBES,L as CONTAINERS_FILENAME,A as CodegenDiagnosticError,Ze as DEFAULT_TARGET,j as FLAGS_FILENAME,Ur as GENERATED_HEADER,Ar as LUNORA_ERROR_CODES,Hr as LUNORA_SOLUTION_RULES,ee as MUTATORS_FILENAME,ae as NOTIFY_FILENAME,qe as OPENRPC_VERSION,kr as PROJECT_CONFIG_FILENAMES,xe as QUEUES_FILENAME,ir as SCHEMA_SNAPSHOT_FILENAME,t as SCHEMA_SNAPSHOT_VERSION,Nr as SDK_LANGUAGES,gr as SDK_TARGETS,Me as SHAPES_FILENAME,dr as SchemaSnapshotParseError,e as VERSION,ye as WORKFLOWS_FILENAME,Ke as buildOpenApiDocument,we as buildOpenRpcDocument,pr as buildSchemaSnapshot,b as capabilitiesUsedBy,Vr as createCodegenProject,n as describeErrorLevelFindings,v as diagnosticAt,s as diffSchemaSnapshots,g as discoverAgents,I as discoverAuthApiCalls,M as discoverContainers,P as discoverCrons,B as discoverFlags,W as discoverFunctions,V as discoverHttpRoutes,Q as discoverHyperdriveCalls,w as discoverInserts,Y as discoverMaskProcedures,Z as discoverMigrations,re as discoverMutators,te as discoverNondeterministicCalls,ie as discoverNotifyCalls,me as discoverNotifyChannels,fe as discoverNotifyConfig,le as discoverQueries,Se as discoverQueues,ue as discoverR2sqlCalls,Ne as discoverRlsMetadata,ve as discoverRlsProcedures,Oe as discoverSandboxUsage,Te as discoverSchema,Fe as discoverShapes,De as discoverStorageRulesMetadata,Ue as discoverWorkflows,wr as emitAgents,Zr as emitApi,He as emitApp,$r as emitCollections,Jr as emitContainers,oo as emitCrons,mo as emitDataModel,_r as emitDrizzleSchema,Mr as emitFunctions,eo as emitInternalApi,Ve as emitOpenApi,ze as emitOpenApiModule,Je as emitOpenRpc,Ye as emitOpenRpcModule,to as emitScheduler,Pr as emitServer,br as emitShard,so as emitVectors,Yr as emitWorkflows,ao as emitWranglerCronTriggers,l as errorAdvisoryNames,c as errorPlatformDiagnosticNames,nr as evaluateSchemaDrift,jr as findLunoraSolution,Wr as findProjectConfigFile,zr as findTsconfig,xr as fingerprintSchemaSources,y as foldCapabilitySignals,m as formatAdvisories,Or as generateSdk,Be as isD1GlobalTable,ke as isHyperdriveGlobalTable,R as isTestPath,po as isTypedSchema,f as lintSchema,T as listLunoraSourceFiles,tr as loadProjectConfig,U as mayReadCapabilityContext,lr as parseSchemaSnapshot,$e as platformMatrixIds,pe as readPackageDependencies,sr as readProjectConfigLiterals,er as readProjectTarget,Ie as readServiceBindings,Tr as redact,Qr as refreshCodegenProject,rr as resolveCodegenTarget,_e as resolveServiceBindings,mr as runCodegen,Er as schemaFromIr,hr as secretKindOf,a as serializeSchemaSnapshot,x as sortedUniqueNames,G as sourceCapabilitySignals,d as toAdvisorContext,vr as validatorIrToJsonSchema};
+import{SCHEMA_SNAPSHOT_VERSION as t,diffSchemaSnapshots as s,serializeSchemaSnapshot as a}from"./packem_shared/SCHEMA_SNAPSHOT_VERSION-C0oHwiJZ.mjs";import{formatAdvisories as m,lintSchema as f,toAdvisorContext as d}from"./packem_shared/formatAdvisories-BCVASH7N.mjs";import{describeErrorLevelFindings as n,errorAdvisoryNames as l,errorPlatformDiagnosticNames as c,sortedUniqueNames as x}from"./packem_shared/describeErrorLevelFindings-vzaGS9KL.mjs";import{CAPABILITY_PROBES as E}from"./packem_shared/CAPABILITY_PROBES-brcmKenl.mjs";import{CodegenDiagnosticError as A,diagnosticAt as v}from"./packem_shared/CodegenDiagnosticError-BUXlG3P-.mjs";import{AGENTS_FILENAME as N,discoverAgents as g}from"./packem_shared/AGENTS_FILENAME-B6-kjzM3.mjs";import{isTestPath as R,listLunoraSourceFiles as T}from"./packem_shared/isTestPath-B81lOULB.mjs";import{default as I}from"./packem_shared/discoverAuthApiCalls-xs0ONfI-.mjs";import{CONTAINERS_FILENAME as L,discoverContainers as M}from"./packem_shared/CONTAINERS_FILENAME-dFRtAyIe.mjs";import{default as P}from"./packem_shared/discoverCrons-DBnCama4.mjs";import{capabilitiesUsedBy as b,foldCapabilitySignals as y,mayReadCapabilityContext as U,sourceCapabilitySignals as G}from"./packem_shared/capabilitiesUsedBy-QgSZyE0T.mjs";import{FLAGS_FILENAME as j,discoverFlags as B}from"./packem_shared/FLAGS_FILENAME-Bf0MSlHH.mjs";import{default as W}from"./packem_shared/discoverFunctions-CbxZGGj0.mjs";import{default as V}from"./packem_shared/discoverHttpRoutes-DgfoyNcf.mjs";import{default as Q}from"./packem_shared/discoverHyperdriveCalls-CwnXgjFJ.mjs";import{default as w}from"./packem_shared/discoverInserts-mHOX_dJR.mjs";import{d as Y}from"./packem_shared/index-CkS96b8a.mjs";import{default as Z}from"./packem_shared/discoverMigrations-C9mLIhGZ.mjs";import{MUTATORS_FILENAME as ee,discoverMutators as re}from"./packem_shared/MUTATORS_FILENAME-qVDmv8st.mjs";import{default as te}from"./packem_shared/discoverNondeterministicCalls-9ZDpRptb.mjs";import{NOTIFY_FILENAME as ae,discoverNotifyCalls as ie,discoverNotifyChannels as me,discoverNotifyConfig as fe}from"./packem_shared/NOTIFY_FILENAME-CLoeWMb5.mjs";import{default as pe}from"./packem_shared/readPackageDependencies-RHhGiz0k.mjs";import{default as le}from"./packem_shared/discoverQueries-CfxkjP5X.mjs";import{QUEUES_FILENAME as xe,discoverQueues as Se}from"./packem_shared/QUEUES_FILENAME-CsRy4VTF.mjs";import{default as ue}from"./packem_shared/discoverR2sqlCalls-XBhs4XRZ.mjs";import{default as ve}from"./packem_shared/discoverRlsProcedures-TskedRMh.mjs";import{default as Ne}from"./packem_shared/discoverRlsMetadata-Cb8JR1b4.mjs";import{discoverSandboxUsage as Oe}from"./packem_shared/discoverSandboxUsage-w6Q3RvxZ.mjs";import{default as Te}from"./packem_shared/discoverSchema-BtsX-CN9.mjs";import{readServiceBindings as Ie,resolveServiceBindings as _e}from"./packem_shared/readServiceBindings-DvqIThzd.mjs";import{SHAPES_FILENAME as Me,discoverShapes as Fe}from"./packem_shared/SHAPES_FILENAME-DkBUN9dK.mjs";import{default as De}from"./packem_shared/discoverStorageRulesMetadata-BPJplDfz.mjs";import{WORKFLOWS_FILENAME as ye,discoverWorkflows as Ue}from"./packem_shared/WORKFLOWS_FILENAME-CdeS224T.mjs";import{emitApp as He}from"./packem_shared/emitApp-BOUdd-2R.mjs";import{isD1GlobalTable as Be,isHyperdriveGlobalTable as ke}from"./packem_shared/isD1GlobalTable-udvHAAzD.mjs";import{buildOpenApiDocument as Ke,emitOpenApi as Ve,emitOpenApiModule as ze}from"./packem_shared/buildOpenApiDocument-DFv-RYZU.mjs";import{OPENRPC_VERSION as qe,buildOpenRpcDocument as we,emitOpenRpc as Je,emitOpenRpcModule as Ye}from"./packem_shared/OPENRPC_VERSION-CCY7xqSL.mjs";import{DEFAULT_TARGET as Ze,platformMatrixIds as $e,readProjectTarget as er,resolveCodegenTarget as rr}from"./packem_shared/DEFAULT_TARGET-BnQiNNKu.mjs";import{l as tr,r as sr}from"./packem_shared/project-config-file-BV7RR-l6.mjs";import{SCHEMA_SNAPSHOT_FILENAME as ir,runCodegen as mr}from"./packem_shared/SCHEMA_SNAPSHOT_FILENAME-CSjCtmZi.mjs";import{SchemaSnapshotParseError as dr,buildSchemaSnapshot as pr,evaluateSchemaDrift as nr,parseSchemaSnapshot as lr}from"./packem_shared/SchemaSnapshotParseError-BRJT7c2k.mjs";import{default as xr}from"./packem_shared/fingerprintSchemaSources-eVG9aVt0.mjs";import{schemaFromIr as Er}from"./packem_shared/schemaFromIr-BWFnvCVg.mjs";import{LUNORA_ERROR_CODES as Ar,validatorIrToJsonSchema as vr}from"./packem_shared/LUNORA_ERROR_CODES-C2s0xWQD.mjs";import{SDK_LANGUAGES as Nr,SDK_TARGETS as gr,generateSdk as Or}from"./sdk/index.mjs";import{redact as Tr,secretKindOf as hr}from"./packem_shared/redact-Cy14LEnc.mjs";import{default as _r}from"./packem_shared/emitDrizzleSchema-DitcRZ1a.mjs";import{default as Mr}from"./packem_shared/emitFunctions-BeKgL3dl.mjs";import{e as Pr}from"./packem_shared/server-DAvi_bv_.mjs";import{e as br}from"./packem_shared/shard-Av4rUyYS.mjs";import{G as Ur}from"./packem_shared/shared-DnCokNcE.mjs";import{MESSAGE_SOLUTIONS as Hr,findSolutionByMessage as jr}from"@lunora/errors";import{PROJECT_CONFIG_FILENAMES as kr,findProjectConfigFile as Wr}from"./packem_shared/PROJECT_CONFIG_FILENAMES-DzOu-lSc.mjs";import{createCodegenProject as Vr,findTsconfig as zr,refreshCodegenProject as Qr}from"./packem_shared/createCodegenProject-V51_yBw3.mjs";import{s as wr,t as Jr,u as Yr}from"./packem_shared/shard-runtime-CkTgY8tL.mjs";import{emitApi as Zr,emitCollections as $r,emitInternalApi as eo}from"./packem_shared/emitApi-Zx6VPN-7.mjs";import{emitCrons as oo,emitScheduler as to,emitVectors as so,emitWranglerCronTriggers as ao}from"./packem_shared/emitCrons-BQW2lviZ.mjs";import{emitDataModel as mo}from"./packem_shared/emitDataModel-BskFt9Wv.mjs";import{isTypedSchema as po}from"./packem_shared/isTypedSchema-CKzc3ioR.mjs";const e="0.0.0";export{N as AGENTS_FILENAME,E as CAPABILITY_PROBES,L as CONTAINERS_FILENAME,A as CodegenDiagnosticError,Ze as DEFAULT_TARGET,j as FLAGS_FILENAME,Ur as GENERATED_HEADER,Ar as LUNORA_ERROR_CODES,Hr as LUNORA_SOLUTION_RULES,ee as MUTATORS_FILENAME,ae as NOTIFY_FILENAME,qe as OPENRPC_VERSION,kr as PROJECT_CONFIG_FILENAMES,xe as QUEUES_FILENAME,ir as SCHEMA_SNAPSHOT_FILENAME,t as SCHEMA_SNAPSHOT_VERSION,Nr as SDK_LANGUAGES,gr as SDK_TARGETS,Me as SHAPES_FILENAME,dr as SchemaSnapshotParseError,e as VERSION,ye as WORKFLOWS_FILENAME,Ke as buildOpenApiDocument,we as buildOpenRpcDocument,pr as buildSchemaSnapshot,b as capabilitiesUsedBy,Vr as createCodegenProject,n as describeErrorLevelFindings,v as diagnosticAt,s as diffSchemaSnapshots,g as discoverAgents,I as discoverAuthApiCalls,M as discoverContainers,P as discoverCrons,B as discoverFlags,W as discoverFunctions,V as discoverHttpRoutes,Q as discoverHyperdriveCalls,w as discoverInserts,Y as discoverMaskProcedures,Z as discoverMigrations,re as discoverMutators,te as discoverNondeterministicCalls,ie as discoverNotifyCalls,me as discoverNotifyChannels,fe as discoverNotifyConfig,le as discoverQueries,Se as discoverQueues,ue as discoverR2sqlCalls,Ne as discoverRlsMetadata,ve as discoverRlsProcedures,Oe as discoverSandboxUsage,Te as discoverSchema,Fe as discoverShapes,De as discoverStorageRulesMetadata,Ue as discoverWorkflows,wr as emitAgents,Zr as emitApi,He as emitApp,$r as emitCollections,Jr as emitContainers,oo as emitCrons,mo as emitDataModel,_r as emitDrizzleSchema,Mr as emitFunctions,eo as emitInternalApi,Ve as emitOpenApi,ze as emitOpenApiModule,Je as emitOpenRpc,Ye as emitOpenRpcModule,to as emitScheduler,Pr as emitServer,br as emitShard,so as emitVectors,Yr as emitWorkflows,ao as emitWranglerCronTriggers,l as errorAdvisoryNames,c as errorPlatformDiagnosticNames,nr as evaluateSchemaDrift,jr as findLunoraSolution,Wr as findProjectConfigFile,zr as findTsconfig,xr as fingerprintSchemaSources,y as foldCapabilitySignals,m as formatAdvisories,Or as generateSdk,Be as isD1GlobalTable,ke as isHyperdriveGlobalTable,R as isTestPath,po as isTypedSchema,f as lintSchema,T as listLunoraSourceFiles,tr as loadProjectConfig,U as mayReadCapabilityContext,lr as parseSchemaSnapshot,$e as platformMatrixIds,pe as readPackageDependencies,sr as readProjectConfigLiterals,er as readProjectTarget,Ie as readServiceBindings,Tr as redact,Qr as refreshCodegenProject,rr as resolveCodegenTarget,_e as resolveServiceBindings,mr as runCodegen,Er as schemaFromIr,hr as secretKindOf,a as serializeSchemaSnapshot,x as sortedUniqueNames,G as sourceCapabilitySignals,d as toAdvisorContext,vr as validatorIrToJsonSchema};

package/dist/sdk/index.d.mts

@@ -0,0 +1,288 @@
+import { LanguageName } from 'quicktype-core';
+/**
+ * Language-agnostic half of SDK generation: turn an OpenRPC document
+ * (`_generated/openrpc.json`, see {@link file://../openrpc.ts}) into the parsed
+ * shape every per-language target renders from.
+ *
+ * Nothing here knows about a target language. A target supplies its own member
+ * naming and templates (see {@link file://./targets}); everything that would
+ * otherwise be re-derived per language — how a `functionPath` splits, which
+ * runtime verb a kind maps to, whether a schema is real or the untyped
+ * placeholder, how namespaces group and sort — lives here exactly once.
+ *
+ * That single-source rule is not stylistic. `paths.ts` documents the same
+ * discipline for namespaces ("if these ever disagree, runtime dispatch silently
+ * misses functions"), and the failure mode here is the same in a new costume: a
+ * target that re-derives a model name renders an import pointing at a class
+ * quicktype never emitted.
+ *
+ * Deriving names in one place is necessary but NOT sufficient, because only
+ * half the decision is ours: quicktype chooses whether a predicted name becomes
+ * a declared type, and different backends answer differently for the same
+ * schema. {@link withDeclaredModels} reconciles the two halves before a target
+ * renders anything.
+ */
+/** One OpenRPC method as {@link file://../openrpc.ts} emits it. */
+interface OpenRpcMethod {
+  name: string;
+  params?: ReadonlyArray<{
+    name: string;
+    schema?: Record<string, unknown>;
+  }>;
+  result?: {
+    name: string;
+    schema?: Record<string, unknown>;
+  };
+  summary?: string;
+  "x-lunora-function-kind"?: string;
+}
+/** The `_generated/openrpc.json` document. */
+interface OpenRpcDocument {
+  info?: {
+    title?: string;
+    version?: string;
+  };
+  methods: ReadonlyArray<OpenRpcMethod>;
+}
+/** The runtime verbs a generated SDK can call. Mirrors the client transports. */
+type RuntimeVerb = "action" | "mutation" | "query";
+/** One RPC function, parsed and language-neutral. */
+interface SdkMethod {
+  /**
+   * Where this function's ARGUMENT nulls mean "unset" and where they mean
+   * "null" — see {@link ModelNullPaths}.
+   *
+   * On the method rather than on a shared render input because it is a
+   * per-method fact and the parser already holds the schema it comes from. Read
+   * by the three targets whose rendered models cannot tell the two apart
+   * (ruby, rust, swift); the other five have a marker of their own and ignore
+   * it.
+   */
+  argsNullPaths: ModelNullPaths;
+  /**
+   * Generated args model name, or `undefined` when NO model could be named for
+   * this function's arguments.
+   *
+   * `undefined` does NOT mean "takes no arguments" — see {@link SdkMethod.takesArgs}.
+   * A schema carrying a `v.bigint()` or `v.bytes()` gets no model deliberately
+   * (`hasUnrepresentableWireType`), and a backend that cannot name a shape leaves
+   * it undeclared. Both still take arguments, just untyped ones.
+   */
+  argsType: string | undefined;
+  /** Raw exported function name (`"list"`), before any naming convention. */
+  functionName: string;
+  /** The wire identifier (`"messages:list"`), emitted verbatim into calls. */
+  functionPath: string;
+  /** Raw file namespace (`"messages"`), before any naming convention. */
+  namespace: string;
+  /** Generated result model name, or `undefined` while the result is untyped. */
+  resultType: string | undefined;
+  /** Human summary for the doc comment. */
+  summary: string;
+  /**
+   * Whether this function declares arguments at all, independent of whether a
+   * model could be named for them.
+   *
+   * A target emits three shapes from this: a TYPED parameter when `argsType` is
+   * set, an UNTYPED wire-shaped parameter when it is not but this is true, and no
+   * parameter at all when this is false. Collapsing the middle case into the last
+   * is what made `v.bigint()` functions uncallable with arguments.
+   */
+  takesArgs: boolean;
+  /** Which runtime verb this dispatches to. */
+  verb: RuntimeVerb;
+}
+/** One namespace's functions, sorted. */
+interface SdkNamespace {
+  methods: ReadonlyArray<SdkMethod>;
+  /** Raw namespace (`"messages"`); a target applies its own casing. */
+  name: string;
+}
+/**
+ * True when a schema actually describes a shape.
+ *
+ * `openrpc.ts` emits a description-only placeholder for any function without a
+ * declared `.output()` (the return type is TS-inferred and absent from the IR).
+ * A placeholder must never become a generated model: quicktype would render an
+ * empty type, and the surface would decode every response into it — silently
+ * discarding the real payload rather than leaving it untyped.
+ */
+declare const isTypedSchema: (schema: Record<string, unknown> | undefined) => boolean;
+/**
+ * A path from a model's root to one property. `*` stands for every element of an
+ * array or every value of a record, neither of which has named positions.
+ */
+type SchemaPath = ReadonlyArray<string>;
+/**
+ * Where a model's nulls mean different things — the one fact a generated model
+ * flattens away, and the reason three ports could not send a `v.nullable()`
+ * argument at all.
+ *
+ * An unset `v.optional()` and a `v.nullable()` set to null are the SAME value in
+ * every generated model (a nil field), and opposite things on the wire: the
+ * validator rejects an explicit null for the first and requires the key present
+ * for the second. Neither Ruby, Rust nor Swift renders a marker telling them
+ * apart, so the distinction is computed here, from the schema, where `required`
+ * still exists — and handed to the targets that need it.
+ *
+ * Two lists rather than one because the ports need opposite operations. Ruby and
+ * Rust project a whole value tree and prune nulls, so they prune at
+ * {@link ModelNullPaths.optional} and nowhere else — which also stops them
+ * dropping a legitimate null inside a record or an array, as a blanket prune
+ * does. Swift's `JSONEncoder` has already dropped every struct-property nil
+ * before the transport sees a tree, so it restores nulls at
+ * {@link ModelNullPaths.nullable} instead: an absent key at a required path can
+ * only have been a nil, so putting the null back is exact.
+ *
+ * A `$ref` is NOT resolved. `openrpc.ts` inlines everything it emits, so this
+ * never comes up for a generated document — but `--spec` accepts a hand-written
+ * one, and there a `$ref`'d sub-object contributes no paths at all: the ports
+ * that prune would send its unset optionals as null, and Swift would not restore
+ * its nullables. Inline the schema, or teach this to follow the pointer.
+ *
+ * Both lists name PROPERTIES only. A record's values and an array's elements can
+ * be null too, but no port drops one: the pruning ports prune at `optional`
+ * paths, which a `*` position can never be, and `JSONEncoder` drops a nil only
+ * from a struct property — a nil inside a dictionary or array encodes as null.
+ * Listing a `*` leaf would also make Swift's restore INVENT record keys that
+ * were never there, which is why the walk records the path it descends through
+ * but never the `*` position itself.
+ */
+interface ModelNullPaths {
+  /** Required properties that permit null — a null there is a VALUE and must survive. */
+  nullable: ReadonlyArray<SchemaPath>;
+  /** Properties absent from their object's `required` — a null there means UNSET. */
+  optional: ReadonlyArray<SchemaPath>;
+}
+/** What a target renders from. */
+interface SdkRenderInput {
+  /**
+   * The rendered model source, to be written as the target's model file.
+   *
+   * Empty for a target that emits its own model FILES via
+   * {@link SdkTarget.renderModels} — those are already written, and this string
+   * exists only so the declared-model reconciliation reads one shape.
+   */
+  models: string;
+  /** Namespaces and their functions, already sorted. */
+  namespaces: ReadonlyArray<SdkNamespace>;
+}
+/**
+ * One directory or file of the hand-written transport, and where it lands in the
+ * output.
+ *
+ * `from` is relative to `sdks/<target id>/` and `to` is relative to `--out`. The
+ * two differ because a repo layout and a consumable layout are not the same
+ * shape: the Ruby transport lives under `lib/` so `ruby -Ilib` works in the
+ * repo, while a vendored copy has no `lib` to point at, and the Rust transport
+ * is the repo's root crate but a nested one in the output.
+ *
+ * Only the runtime is listed. A transport's own conformance suite and its
+ * `generated_check/` sample are deliberately absent — they assert against
+ * `protocol/fixtures/`, which is not copied, so vendoring them would ship a user
+ * a test suite that cannot run.
+ */
+interface SdkVendorEntry {
+  /** Path under `sdks/<id>/`. A directory is copied recursively. */
+  from: string;
+  /** Destination path under `--out`. */
+  to: string;
+}
+/** A language target. One per `--lang` value. */
+interface SdkTarget {
+  /** The `--lang` value (`"python"`, `"go"`, …). */
+  id: string;
+  /**
+   * The quicktype backend + renderer options that produce this target's
+   * models, or absent when the target emits its own (see
+   * {@link SdkTarget.renderModels}) or none at all.
+   *
+   * `LanguageName` is quicktype's own union, so a target naming a backend
+   * quicktype does not ship fails to compile rather than at run time.
+   */
+  quicktype?: {
+    lang: LanguageName;
+    rendererOptions?: Record<string, string>;
+  };
+  /**
+   * Render the SDK. Returns file contents keyed by path relative to the
+   * output directory (nested paths are created as needed).
+   *
+   * This includes the BUILD MANIFEST the layout needs — `go.mod`, `Cargo.toml`,
+   * `Package.swift`, a crate root — because those name the vendored transport
+   * and are therefore part of "how this language resolves the copy", not
+   * something a consumer should have to write. Languages that resolve by
+   * directory (Python, Ruby, Java, Kotlin) emit no manifest.
+   */
+  render: (input: SdkRenderInput) => Record<string, string>;
+  /**
+   * Emit this target's models from the schema directly, INSTEAD of quicktype,
+   * as file contents keyed by path relative to the output directory.
+   *
+   * Present only for the two JVM targets, and the exception is earned rather
+   * than a preference: quicktype's Java and Kotlin backends rename properties
+   * and, under `just-types`, emit no mapping metadata, so a model they render
+   * cannot be projected back onto the wire — and the only complete mapping
+   * they offer requires a Jackson / Klaxon / kotlinx dependency, which is the
+   * one thing these JDK-only transports are defined not to have.
+   * `targets/java.ts` records every option that was measured.
+   *
+   * A MAP rather than the single string quicktype returns, because Java takes
+   * one file per class: its single-file render is not compilable Java at all.
+   * The values are still joined for {@link SdkRenderInput.models}, so the
+   * declared-model reconciliation is the same code for every target.
+   */
+  renderModels?: (document: OpenRpcDocument) => Record<string, string>;
+  /**
+   * THIRD-PARTY packages a consuming project must still install, reported by
+   * the CLI. Empty for six of the eight — the transport is vendored and those
+   * six reach the wire with only their standard library.
+   *
+   * A list, and not derivable from the transport, because a target's MODELS can
+   * carry a dependency the transport does not: quicktype's Ruby backend emits
+   * `Dry::Struct` types with no renderer option to avoid them, so a Ruby SDK
+   * needs the gems even though `sdks/ruby` itself is dependency-free.
+   */
+  requires: ReadonlyArray<string>;
+  /**
+   * Which parts of `sdks/<id>/` are the transport, and where they land under
+   * `--out`. See {@link SdkVendorEntry}.
+   */
+  vendor: ReadonlyArray<SdkVendorEntry>;
+}
+/** Every language `lunora sdk generate --lang` accepts, keyed by id. */
+declare const SDK_TARGETS: Readonly<Record<string, SdkTarget>>;
+/** The accepted `--lang` values, sorted — for help text and error messages. */
+declare const SDK_LANGUAGES: ReadonlyArray<string>;
+/** The files a generation run writes, keyed by path relative to the output directory. */
+type SdkFiles = Record<string, string>;
+/** What a generation run produced, plus what it had to weaken and why. */
+interface SdkResult {
+  files: SdkFiles;
+  /**
+   * Model names predicted from the schema that the chosen backend did not
+   * declare, so their call sites fell back to an untyped return. Surfaced
+   * rather than swallowed — silently weaker types are how an SDK looks
+   * finished while returning `Any` everywhere.
+   */
+  undeclared: ReadonlyArray<string>;
+  /**
+   * Functions whose args or result carry a `v.bigint()` or `v.bytes()`. No
+   * typed model can represent those — the wire needs a tagged value that no
+   * generated field produces — so their parameters stay untyped and the
+   * caller passes wire values directly.
+   */
+  unrepresentable: ReadonlyArray<string>;
+}
+/**
+ * Generate the SDK for `document` in `target`'s language.
+ *
+ * Async only because the model layer is: quicktype's renderer is promise-based.
+ * The surface itself is pure, so a target's `render` stays synchronous and
+ * unit-testable without touching quicktype.
+ *
+ * Models are rendered BEFORE the surface because the surface's model references
+ * depend on what the backend actually declared — see {@link withDeclaredModels}.
+ */
+declare const generateSdk: (document: OpenRpcDocument, target: SdkTarget) => Promise<SdkResult>;
+export { type OpenRpcDocument, type OpenRpcMethod, type RuntimeVerb, SDK_LANGUAGES, SDK_TARGETS, type SdkFiles, type SdkMethod, type SdkNamespace, type SdkRenderInput, type SdkResult, type SdkTarget, generateSdk, isTypedSchema };

package/dist/sdk/index.d.ts

@@ -0,0 +1,288 @@
+import { LanguageName } from 'quicktype-core';
+/**
+ * Language-agnostic half of SDK generation: turn an OpenRPC document
+ * (`_generated/openrpc.json`, see {@link file://../openrpc.ts}) into the parsed
+ * shape every per-language target renders from.
+ *
+ * Nothing here knows about a target language. A target supplies its own member
+ * naming and templates (see {@link file://./targets}); everything that would
+ * otherwise be re-derived per language — how a `functionPath` splits, which
+ * runtime verb a kind maps to, whether a schema is real or the untyped
+ * placeholder, how namespaces group and sort — lives here exactly once.
+ *
+ * That single-source rule is not stylistic. `paths.ts` documents the same
+ * discipline for namespaces ("if these ever disagree, runtime dispatch silently
+ * misses functions"), and the failure mode here is the same in a new costume: a
+ * target that re-derives a model name renders an import pointing at a class
+ * quicktype never emitted.
+ *
+ * Deriving names in one place is necessary but NOT sufficient, because only
+ * half the decision is ours: quicktype chooses whether a predicted name becomes
+ * a declared type, and different backends answer differently for the same
+ * schema. {@link withDeclaredModels} reconciles the two halves before a target
+ * renders anything.
+ */
+/** One OpenRPC method as {@link file://../openrpc.ts} emits it. */
+interface OpenRpcMethod {
+  name: string;
+  params?: ReadonlyArray<{
+    name: string;
+    schema?: Record<string, unknown>;
+  }>;
+  result?: {
+    name: string;
+    schema?: Record<string, unknown>;
+  };
+  summary?: string;
+  "x-lunora-function-kind"?: string;
+}
+/** The `_generated/openrpc.json` document. */
+interface OpenRpcDocument {
+  info?: {
+    title?: string;
+    version?: string;
+  };
+  methods: ReadonlyArray<OpenRpcMethod>;
+}
+/** The runtime verbs a generated SDK can call. Mirrors the client transports. */
+type RuntimeVerb = "action" | "mutation" | "query";
+/** One RPC function, parsed and language-neutral. */
+interface SdkMethod {
+  /**
+   * Where this function's ARGUMENT nulls mean "unset" and where they mean
+   * "null" — see {@link ModelNullPaths}.
+   *
+   * On the method rather than on a shared render input because it is a
+   * per-method fact and the parser already holds the schema it comes from. Read
+   * by the three targets whose rendered models cannot tell the two apart
+   * (ruby, rust, swift); the other five have a marker of their own and ignore
+   * it.
+   */
+  argsNullPaths: ModelNullPaths;
+  /**
+   * Generated args model name, or `undefined` when NO model could be named for
+   * this function's arguments.
+   *
+   * `undefined` does NOT mean "takes no arguments" — see {@link SdkMethod.takesArgs}.
+   * A schema carrying a `v.bigint()` or `v.bytes()` gets no model deliberately
+   * (`hasUnrepresentableWireType`), and a backend that cannot name a shape leaves
+   * it undeclared. Both still take arguments, just untyped ones.
+   */
+  argsType: string | undefined;
+  /** Raw exported function name (`"list"`), before any naming convention. */
+  functionName: string;
+  /** The wire identifier (`"messages:list"`), emitted verbatim into calls. */
+  functionPath: string;
+  /** Raw file namespace (`"messages"`), before any naming convention. */
+  namespace: string;
+  /** Generated result model name, or `undefined` while the result is untyped. */
+  resultType: string | undefined;
+  /** Human summary for the doc comment. */
+  summary: string;
+  /**
+   * Whether this function declares arguments at all, independent of whether a
+   * model could be named for them.
+   *
+   * A target emits three shapes from this: a TYPED parameter when `argsType` is
+   * set, an UNTYPED wire-shaped parameter when it is not but this is true, and no
+   * parameter at all when this is false. Collapsing the middle case into the last
+   * is what made `v.bigint()` functions uncallable with arguments.
+   */
+  takesArgs: boolean;
+  /** Which runtime verb this dispatches to. */
+  verb: RuntimeVerb;
+}
+/** One namespace's functions, sorted. */
+interface SdkNamespace {
+  methods: ReadonlyArray<SdkMethod>;
+  /** Raw namespace (`"messages"`); a target applies its own casing. */
+  name: string;
+}
+/**
+ * True when a schema actually describes a shape.
+ *
+ * `openrpc.ts` emits a description-only placeholder for any function without a
+ * declared `.output()` (the return type is TS-inferred and absent from the IR).
+ * A placeholder must never become a generated model: quicktype would render an
+ * empty type, and the surface would decode every response into it — silently
+ * discarding the real payload rather than leaving it untyped.
+ */
+declare const isTypedSchema: (schema: Record<string, unknown> | undefined) => boolean;
+/**
+ * A path from a model's root to one property. `*` stands for every element of an
+ * array or every value of a record, neither of which has named positions.
+ */
+type SchemaPath = ReadonlyArray<string>;
+/**
+ * Where a model's nulls mean different things — the one fact a generated model
+ * flattens away, and the reason three ports could not send a `v.nullable()`
+ * argument at all.
+ *
+ * An unset `v.optional()` and a `v.nullable()` set to null are the SAME value in
+ * every generated model (a nil field), and opposite things on the wire: the
+ * validator rejects an explicit null for the first and requires the key present
+ * for the second. Neither Ruby, Rust nor Swift renders a marker telling them
+ * apart, so the distinction is computed here, from the schema, where `required`
+ * still exists — and handed to the targets that need it.
+ *
+ * Two lists rather than one because the ports need opposite operations. Ruby and
+ * Rust project a whole value tree and prune nulls, so they prune at
+ * {@link ModelNullPaths.optional} and nowhere else — which also stops them
+ * dropping a legitimate null inside a record or an array, as a blanket prune
+ * does. Swift's `JSONEncoder` has already dropped every struct-property nil
+ * before the transport sees a tree, so it restores nulls at
+ * {@link ModelNullPaths.nullable} instead: an absent key at a required path can
+ * only have been a nil, so putting the null back is exact.
+ *
+ * A `$ref` is NOT resolved. `openrpc.ts` inlines everything it emits, so this
+ * never comes up for a generated document — but `--spec` accepts a hand-written
+ * one, and there a `$ref`'d sub-object contributes no paths at all: the ports
+ * that prune would send its unset optionals as null, and Swift would not restore
+ * its nullables. Inline the schema, or teach this to follow the pointer.
+ *
+ * Both lists name PROPERTIES only. A record's values and an array's elements can
+ * be null too, but no port drops one: the pruning ports prune at `optional`
+ * paths, which a `*` position can never be, and `JSONEncoder` drops a nil only
+ * from a struct property — a nil inside a dictionary or array encodes as null.
+ * Listing a `*` leaf would also make Swift's restore INVENT record keys that
+ * were never there, which is why the walk records the path it descends through
+ * but never the `*` position itself.
+ */
+interface ModelNullPaths {
+  /** Required properties that permit null — a null there is a VALUE and must survive. */
+  nullable: ReadonlyArray<SchemaPath>;
+  /** Properties absent from their object's `required` — a null there means UNSET. */
+  optional: ReadonlyArray<SchemaPath>;
+}
+/** What a target renders from. */
+interface SdkRenderInput {
+  /**
+   * The rendered model source, to be written as the target's model file.
+   *
+   * Empty for a target that emits its own model FILES via
+   * {@link SdkTarget.renderModels} — those are already written, and this string
+   * exists only so the declared-model reconciliation reads one shape.
+   */
+  models: string;
+  /** Namespaces and their functions, already sorted. */
+  namespaces: ReadonlyArray<SdkNamespace>;
+}
+/**
+ * One directory or file of the hand-written transport, and where it lands in the
+ * output.
+ *
+ * `from` is relative to `sdks/<target id>/` and `to` is relative to `--out`. The
+ * two differ because a repo layout and a consumable layout are not the same
+ * shape: the Ruby transport lives under `lib/` so `ruby -Ilib` works in the
+ * repo, while a vendored copy has no `lib` to point at, and the Rust transport
+ * is the repo's root crate but a nested one in the output.
+ *
+ * Only the runtime is listed. A transport's own conformance suite and its
+ * `generated_check/` sample are deliberately absent — they assert against
+ * `protocol/fixtures/`, which is not copied, so vendoring them would ship a user
+ * a test suite that cannot run.
+ */
+interface SdkVendorEntry {
+  /** Path under `sdks/<id>/`. A directory is copied recursively. */
+  from: string;
+  /** Destination path under `--out`. */
+  to: string;
+}
+/** A language target. One per `--lang` value. */
+interface SdkTarget {
+  /** The `--lang` value (`"python"`, `"go"`, …). */
+  id: string;
+  /**
+   * The quicktype backend + renderer options that produce this target's
+   * models, or absent when the target emits its own (see
+   * {@link SdkTarget.renderModels}) or none at all.
+   *
+   * `LanguageName` is quicktype's own union, so a target naming a backend
+   * quicktype does not ship fails to compile rather than at run time.
+   */
+  quicktype?: {
+    lang: LanguageName;
+    rendererOptions?: Record<string, string>;
+  };
+  /**
+   * Render the SDK. Returns file contents keyed by path relative to the
+   * output directory (nested paths are created as needed).
+   *
+   * This includes the BUILD MANIFEST the layout needs — `go.mod`, `Cargo.toml`,
+   * `Package.swift`, a crate root — because those name the vendored transport
+   * and are therefore part of "how this language resolves the copy", not
+   * something a consumer should have to write. Languages that resolve by
+   * directory (Python, Ruby, Java, Kotlin) emit no manifest.
+   */
+  render: (input: SdkRenderInput) => Record<string, string>;
+  /**
+   * Emit this target's models from the schema directly, INSTEAD of quicktype,
+   * as file contents keyed by path relative to the output directory.
+   *
+   * Present only for the two JVM targets, and the exception is earned rather
+   * than a preference: quicktype's Java and Kotlin backends rename properties
+   * and, under `just-types`, emit no mapping metadata, so a model they render
+   * cannot be projected back onto the wire — and the only complete mapping
+   * they offer requires a Jackson / Klaxon / kotlinx dependency, which is the
+   * one thing these JDK-only transports are defined not to have.
+   * `targets/java.ts` records every option that was measured.
+   *
+   * A MAP rather than the single string quicktype returns, because Java takes
+   * one file per class: its single-file render is not compilable Java at all.
+   * The values are still joined for {@link SdkRenderInput.models}, so the
+   * declared-model reconciliation is the same code for every target.
+   */
+  renderModels?: (document: OpenRpcDocument) => Record<string, string>;
+  /**
+   * THIRD-PARTY packages a consuming project must still install, reported by
+   * the CLI. Empty for six of the eight — the transport is vendored and those
+   * six reach the wire with only their standard library.
+   *
+   * A list, and not derivable from the transport, because a target's MODELS can
+   * carry a dependency the transport does not: quicktype's Ruby backend emits
+   * `Dry::Struct` types with no renderer option to avoid them, so a Ruby SDK
+   * needs the gems even though `sdks/ruby` itself is dependency-free.
+   */
+  requires: ReadonlyArray<string>;
+  /**
+   * Which parts of `sdks/<id>/` are the transport, and where they land under
+   * `--out`. See {@link SdkVendorEntry}.
+   */
+  vendor: ReadonlyArray<SdkVendorEntry>;
+}
+/** Every language `lunora sdk generate --lang` accepts, keyed by id. */
+declare const SDK_TARGETS: Readonly<Record<string, SdkTarget>>;
+/** The accepted `--lang` values, sorted — for help text and error messages. */
+declare const SDK_LANGUAGES: ReadonlyArray<string>;
+/** The files a generation run writes, keyed by path relative to the output directory. */
+type SdkFiles = Record<string, string>;
+/** What a generation run produced, plus what it had to weaken and why. */
+interface SdkResult {
+  files: SdkFiles;
+  /**
+   * Model names predicted from the schema that the chosen backend did not
+   * declare, so their call sites fell back to an untyped return. Surfaced
+   * rather than swallowed — silently weaker types are how an SDK looks
+   * finished while returning `Any` everywhere.
+   */
+  undeclared: ReadonlyArray<string>;
+  /**
+   * Functions whose args or result carry a `v.bigint()` or `v.bytes()`. No
+   * typed model can represent those — the wire needs a tagged value that no
+   * generated field produces — so their parameters stay untyped and the
+   * caller passes wire values directly.
+   */
+  unrepresentable: ReadonlyArray<string>;
+}
+/**
+ * Generate the SDK for `document` in `target`'s language.
+ *
+ * Async only because the model layer is: quicktype's renderer is promise-based.
+ * The surface itself is pure, so a target's `render` stays synchronous and
+ * unit-testable without touching quicktype.
+ *
+ * Models are rendered BEFORE the surface because the surface's model references
+ * depend on what the backend actually declared — see {@link withDeclaredModels}.
+ */
+declare const generateSdk: (document: OpenRpcDocument, target: SdkTarget) => Promise<SdkResult>;
+export { type OpenRpcDocument, type OpenRpcMethod, type RuntimeVerb, SDK_LANGUAGES, SDK_TARGETS, type SdkFiles, type SdkMethod, type SdkNamespace, type SdkRenderInput, type SdkResult, type SdkTarget, generateSdk, isTypedSchema };

package/dist/{packem_shared/SDK_LANGUAGES-Df_CnJx5.mjs → sdk/index.mjs}

@@ -1,4 +1,4 @@
-import{modelSources as pe,assertDistinctMembers as T,toPascalCase as l,referencedModels as W,generatedHeaderLines as f,commentText as p,argsChoice as $,stringLiteral as m,kotlinLiteral as w,allMethods as x,toSnakeCase as E,parseSpec as Ne,assertGeneratable as Oe,withDeclaredModels as Ce,unrepresentableFunctions as Le,undeclaredModels as Re}from"./isTypedSchema-CKzc3ioR.mjs";import{isTypedSchema as St}from"./isTypedSchema-CKzc3ioR.mjs";const We=async(e,n)=>{if(n.quicktype===void 0)return"";const t=pe(e);if(t.length===0)return"";const{InputData:r,JSONSchemaInput:a,JSONSchemaStore:i,quicktype:o}=await import("quicktype-core");class s extends i{fetch(){return Promise.resolve(void 0)}}const d=new a(new s);for(const g of t)await d.addSource({name:g.name,schema:JSON.stringify(g.schema)});const c=new r;c.addInput(d);const{lines:u}=await o({inputData:c,lang:n.quicktype.lang,rendererOptions:n.quicktype.rendererOptions??{}});return u.join(`
+import{modelSources as pe,assertDistinctMembers as T,toPascalCase as l,referencedModels as W,generatedHeaderLines as f,commentText as p,argsChoice as $,stringLiteral as m,kotlinLiteral as w,allMethods as x,toSnakeCase as E,parseSpec as Ne,assertGeneratable as Oe,withDeclaredModels as Ce,unrepresentableFunctions as Le,undeclaredModels as Re}from"../packem_shared/isTypedSchema-CKzc3ioR.mjs";import{isTypedSchema as St}from"../packem_shared/isTypedSchema-CKzc3ioR.mjs";const We=async(e,n)=>{if(n.quicktype===void 0)return"";const t=pe(e);if(t.length===0)return"";const{InputData:r,JSONSchemaInput:a,JSONSchemaStore:i,quicktype:o}=await import("quicktype-core");class s extends i{fetch(){return Promise.resolve(void 0)}}const d=new a(new s);for(const g of t)await d.addSource({name:g.name,schema:JSON.stringify(g.schema)});const c=new r;c.addInput(d);const{lines:u}=await o({inputData:c,lang:n.quicktype.lang,rendererOptions:n.quicktype.rendererOptions??{}});return u.join(`
 `)},D=`${f("dart").map(e=>`// ${e}`).join(`
 `)}
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/codegen",
-  "version": "1.0.0-alpha.312",
+  "version": "1.0.0-alpha.313",
   "description": "Code generator for Lunora: emits _generated/{api,server,dataModel}.ts from your schema",
   "keywords": [
     "cloudflare",
@@ -40,6 +40,10 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.mjs"
     },
+    "./sdk": {
+      "types": "./dist/sdk/index.d.ts",
+      "import": "./dist/sdk/index.mjs"
+    },
     "./package.json": "./package.json"
   },
   "publishConfig": {