@xano/sdk 1.0.0

package/dist/cli.js

@@ -0,0 +1,165 @@
+import {
+  assertEntryExists,
+  carryRunWarnings,
+  checkStandInTokens,
+  compileBundle,
+  composedChildren,
+  docTokenRefusalIfReplaced,
+  emitterFor,
+  envNameRule,
+  envRefusalIfReplaced,
+  expandShortAttached,
+  exportBundleJson,
+  globalVersionAsked,
+  globalVersionMisuse,
+  isPathlessRun,
+  loadDefault,
+  loadModule,
+  maskAssignments,
+  missingLockDir,
+  nearestLockPath,
+  noteLockCreated,
+  noteRunScope,
+  orphanFixUps,
+  parseArgs,
+  printHelp,
+  readVersion,
+  refreshAgentGuidance,
+  refreshRouteManifest,
+  renameCandidatesFor,
+  resolveHelpRequest,
+  resolveLockPath,
+  run,
+  setGuidFixUp,
+  tsxRemedy,
+  withoutSecretValue
+} from "./chunk-ETO6LGLD.js";
+import "./chunk-ZIY7RNUT.js";
+import "./chunk-DAD3ONIS.js";
+import "./chunk-HHN734BU.js";
+import "./chunk-LPECSJ2J.js";
+import "./chunk-6NNTNXN7.js";
+import "./chunk-QCNYHBL7.js";
+import "./chunk-2ZUEE4EK.js";
+import "./chunk-AN6BL47T.js";
+import "./chunk-ET4Y4XCB.js";
+import "./chunk-SWBF2LTK.js";
+import "./chunk-UZ6QQWJT.js";
+import "./chunk-A3UDOZB6.js";
+import "./chunk-2MNLRIOX.js";
+import "./chunk-3M4LFYNQ.js";
+import "./chunk-AM4FKL4J.js";
+import "./chunk-Q325JKYB.js";
+import "./chunk-STSFNCY4.js";
+import "./chunk-I4F5TCJH.js";
+import "./chunk-5QU2P5CA.js";
+import "./chunk-ZYJP6BOO.js";
+import "./chunk-QO6BVGS5.js";
+import "./chunk-JZGVVJSI.js";
+import "./chunk-7G3CTU7I.js";
+import "./chunk-6PBR37LN.js";
+import "./chunk-T5KELPAR.js";
+import "./chunk-622HUCZT.js";
+import "./chunk-NAQDMEHV.js";
+import "./chunk-5A2PLKZB.js";
+import "./chunk-AHJWCYQO.js";
+import "./chunk-DX4QR4B2.js";
+import "./chunk-6QXLMMT3.js";
+import "./chunk-ZFDZKNGG.js";
+import "./chunk-FWD7AL6N.js";
+import "./chunk-2GNFDZA2.js";
+import "./chunk-JTUKLCXS.js";
+import "./chunk-4KHEMC32.js";
+import "./chunk-U64O2MXY.js";
+import "./chunk-ROY4YAEQ.js";
+import "./chunk-P2HAGF6H.js";
+import "./chunk-TLQE7ZN3.js";
+import "./chunk-WRBKLYSJ.js";
+import "./chunk-3LDULPRE.js";
+import "./chunk-XW6KISBB.js";
+import "./chunk-AWQ7BQTQ.js";
+import "./chunk-EUUUMY7J.js";
+import "./chunk-YLDALTWZ.js";
+import "./chunk-5FBYXK5P.js";
+import "./chunk-LLNZGEFK.js";
+import "./chunk-QXTKSOFI.js";
+import "./chunk-X2NL4KUO.js";
+import "./chunk-OPHB5ORL.js";
+import "./chunk-UCQ2VUTG.js";
+import "./chunk-DGWHAVRG.js";
+import "./chunk-JGE7CAWB.js";
+import "./chunk-PTHVMXZI.js";
+import "./chunk-MXHSQOC4.js";
+import "./chunk-6IUMKYWI.js";
+import "./chunk-2CMJZDCL.js";
+import "./chunk-CTMO46PK.js";
+import "./chunk-ZDPP6RKB.js";
+import "./chunk-K5BBGTYZ.js";
+import "./chunk-LQCMKAJ7.js";
+import "./chunk-YGZHHAAB.js";
+import "./chunk-XVBGLISP.js";
+import "./chunk-6HO3NCSJ.js";
+import "./chunk-5V5XU32D.js";
+import "./chunk-GSGDWJB5.js";
+import "./chunk-HVRUQXGD.js";
+import "./chunk-ERVIASGL.js";
+import "./chunk-4POWHT2K.js";
+import "./chunk-H2V3N23D.js";
+import "./chunk-3JDU4VRL.js";
+import "./chunk-WTPZRR4I.js";
+import "./chunk-UTI5G6OJ.js";
+import "./chunk-2EZ3ZJZZ.js";
+import "./chunk-6MR5TI5V.js";
+import "./chunk-5ZSO4T2G.js";
+import "./chunk-XNCP4KYO.js";
+import "./chunk-AKNCFVKZ.js";
+import "./chunk-YU4HSQW7.js";
+import "./chunk-TFFGOFVZ.js";
+import "./chunk-G554NZNI.js";
+import "./chunk-N5GKCWE5.js";
+import "./chunk-OXA6PSZT.js";
+import "./chunk-VAX3UZOY.js";
+import "./chunk-NZOWWHU5.js";
+import "./chunk-4BW2SG2N.js";
+import "./chunk-TTEIYD5P.js";
+import "./chunk-CIMQZRRE.js";
+import "./chunk-OHX6MIUZ.js";
+import "./chunk-36JUQZVQ.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  assertEntryExists,
+  carryRunWarnings,
+  checkStandInTokens,
+  compileBundle,
+  composedChildren,
+  docTokenRefusalIfReplaced,
+  emitterFor,
+  envNameRule,
+  envRefusalIfReplaced,
+  expandShortAttached,
+  exportBundleJson,
+  globalVersionAsked,
+  globalVersionMisuse,
+  isPathlessRun,
+  loadDefault,
+  loadModule,
+  maskAssignments,
+  missingLockDir,
+  nearestLockPath,
+  noteLockCreated,
+  noteRunScope,
+  orphanFixUps,
+  parseArgs,
+  printHelp,
+  readVersion,
+  refreshAgentGuidance,
+  refreshRouteManifest,
+  renameCandidatesFor,
+  resolveHelpRequest,
+  resolveLockPath,
+  run,
+  setGuidFixUp,
+  tsxRemedy,
+  withoutSecretValue
+};
+//# sourceMappingURL=cli.js.map

package/dist/codegen-command-VR2GWR6C.js

@@ -0,0 +1,173 @@
+import {
+  blameGeneratedFile,
+  carriedSeedRows,
+  envExampleNames,
+  fetchWorkspaceBundle,
+  installedSdkSkew,
+  isMissingDependencyError,
+  lockWriteFailure,
+  missingDependency,
+  placeGeneratedFiles,
+  readBundleFile,
+  refreshSelector,
+  refuseDuplicateSourceGuids,
+  reportSeedRows,
+  reportStrictWarnings,
+  routeManifestFor,
+  runInitFromCommand,
+  sdkSkewNote,
+  seedRowsLanding,
+  seedRowsListed,
+  stableCodegenMarker,
+  unverifiedReason,
+  verifyCrashEntry,
+  verifyPulledTree,
+  withSourceIdentities,
+  writeBundleEnvValues,
+  writeDocumentationTokens,
+  writeSourceLock
+} from "./chunk-X677DMZM.js";
+import "./chunk-LRN4ZJCQ.js";
+import "./chunk-RTJRZFFY.js";
+import "./chunk-65HWOMGV.js";
+import "./chunk-TPHWJ7UG.js";
+import "./chunk-AOSYVMUS.js";
+import "./chunk-CJHQKJU4.js";
+import "./chunk-3DRXWLJ5.js";
+import "./chunk-X4DVXBFY.js";
+import "./chunk-TRJCALW3.js";
+import "./chunk-LIEOKXKD.js";
+import "./chunk-D7VGG3WS.js";
+import "./chunk-2TFRR6JV.js";
+import "./chunk-HRVBLCVJ.js";
+import "./chunk-YHEFQUQB.js";
+import "./chunk-ETO6LGLD.js";
+import "./chunk-ZIY7RNUT.js";
+import "./chunk-DAD3ONIS.js";
+import "./chunk-HHN734BU.js";
+import "./chunk-LPECSJ2J.js";
+import "./chunk-6NNTNXN7.js";
+import "./chunk-QCNYHBL7.js";
+import "./chunk-2ZUEE4EK.js";
+import "./chunk-AN6BL47T.js";
+import "./chunk-ET4Y4XCB.js";
+import "./chunk-SWBF2LTK.js";
+import "./chunk-UZ6QQWJT.js";
+import "./chunk-A3UDOZB6.js";
+import "./chunk-2MNLRIOX.js";
+import "./chunk-3M4LFYNQ.js";
+import "./chunk-AM4FKL4J.js";
+import "./chunk-Q325JKYB.js";
+import "./chunk-STSFNCY4.js";
+import "./chunk-I4F5TCJH.js";
+import "./chunk-5QU2P5CA.js";
+import "./chunk-ZYJP6BOO.js";
+import "./chunk-QO6BVGS5.js";
+import "./chunk-JZGVVJSI.js";
+import "./chunk-7G3CTU7I.js";
+import "./chunk-6PBR37LN.js";
+import "./chunk-T5KELPAR.js";
+import "./chunk-622HUCZT.js";
+import "./chunk-NAQDMEHV.js";
+import "./chunk-5A2PLKZB.js";
+import "./chunk-AHJWCYQO.js";
+import "./chunk-DX4QR4B2.js";
+import "./chunk-6QXLMMT3.js";
+import "./chunk-ZFDZKNGG.js";
+import "./chunk-FWD7AL6N.js";
+import "./chunk-2GNFDZA2.js";
+import "./chunk-JTUKLCXS.js";
+import "./chunk-4KHEMC32.js";
+import "./chunk-U64O2MXY.js";
+import "./chunk-ROY4YAEQ.js";
+import "./chunk-P2HAGF6H.js";
+import "./chunk-TLQE7ZN3.js";
+import "./chunk-WRBKLYSJ.js";
+import "./chunk-3LDULPRE.js";
+import "./chunk-XW6KISBB.js";
+import "./chunk-AWQ7BQTQ.js";
+import "./chunk-EUUUMY7J.js";
+import "./chunk-YLDALTWZ.js";
+import "./chunk-5FBYXK5P.js";
+import "./chunk-LLNZGEFK.js";
+import "./chunk-QXTKSOFI.js";
+import "./chunk-X2NL4KUO.js";
+import "./chunk-3KZCLN4Z.js";
+import "./chunk-FXFV3KU6.js";
+import "./chunk-OPHB5ORL.js";
+import "./chunk-UCQ2VUTG.js";
+import "./chunk-DGWHAVRG.js";
+import "./chunk-27GWNP2I.js";
+import "./chunk-3YW23UFH.js";
+import "./chunk-JGE7CAWB.js";
+import "./chunk-PTHVMXZI.js";
+import "./chunk-MXHSQOC4.js";
+import "./chunk-6IUMKYWI.js";
+import "./chunk-2CMJZDCL.js";
+import "./chunk-CTMO46PK.js";
+import "./chunk-ZDPP6RKB.js";
+import "./chunk-K5BBGTYZ.js";
+import "./chunk-LQCMKAJ7.js";
+import "./chunk-YGZHHAAB.js";
+import "./chunk-XVBGLISP.js";
+import "./chunk-6HO3NCSJ.js";
+import "./chunk-5V5XU32D.js";
+import "./chunk-GSGDWJB5.js";
+import "./chunk-HVRUQXGD.js";
+import "./chunk-ERVIASGL.js";
+import "./chunk-4POWHT2K.js";
+import "./chunk-H2V3N23D.js";
+import "./chunk-3JDU4VRL.js";
+import "./chunk-WTPZRR4I.js";
+import "./chunk-UTI5G6OJ.js";
+import "./chunk-2EZ3ZJZZ.js";
+import "./chunk-6MR5TI5V.js";
+import "./chunk-5ZSO4T2G.js";
+import "./chunk-XNCP4KYO.js";
+import "./chunk-AKNCFVKZ.js";
+import "./chunk-YU4HSQW7.js";
+import "./chunk-TFFGOFVZ.js";
+import "./chunk-EHP3WPEG.js";
+import "./chunk-L5JYN3NM.js";
+import "./chunk-Q7DGTQ5G.js";
+import "./chunk-G554NZNI.js";
+import "./chunk-N5GKCWE5.js";
+import "./chunk-OXA6PSZT.js";
+import "./chunk-VAX3UZOY.js";
+import "./chunk-NZOWWHU5.js";
+import "./chunk-4BW2SG2N.js";
+import "./chunk-TTEIYD5P.js";
+import "./chunk-CIMQZRRE.js";
+import "./chunk-OHX6MIUZ.js";
+import "./chunk-36JUQZVQ.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  blameGeneratedFile,
+  carriedSeedRows,
+  envExampleNames,
+  fetchWorkspaceBundle,
+  installedSdkSkew,
+  isMissingDependencyError,
+  lockWriteFailure,
+  missingDependency,
+  placeGeneratedFiles,
+  readBundleFile,
+  refreshSelector,
+  refuseDuplicateSourceGuids,
+  reportSeedRows,
+  reportStrictWarnings,
+  routeManifestFor,
+  runInitFromCommand,
+  sdkSkewNote,
+  seedRowsLanding,
+  seedRowsListed,
+  stableCodegenMarker,
+  unverifiedReason,
+  verifyCrashEntry,
+  verifyPulledTree,
+  withSourceIdentities,
+  writeBundleEnvValues,
+  writeDocumentationTokens,
+  writeSourceLock
+};
+//# sourceMappingURL=codegen-command-VR2GWR6C.js.map

package/dist/codegen.d.ts

@@ -0,0 +1,115 @@
+import { S as Statement, h as FieldDescriptor, z as ResponseDef } from './response-HlXahv4K.js';
+import { u as Tag, i as FilterXdo, v as TaggedValue } from './xdo-CxDr2Q1C.js';
+
+/** A stored statement envelope as it appears in a Xano bundle's `run[]`. */
+type RawEnvelope = Record<string, unknown>;
+/**
+ * Wrap a stored statement envelope so it compiles back to itself verbatim.
+ *
+ * Every key present on `envelope` — including keys this SDK does not model —
+ * survives untouched, and a key the envelope does not carry is NOT invented: an
+ * engine that omits a key at its default gets that exact shape back.
+ *
+ * @param envelope A stored `run[]` entry. Must be an object carrying a `name`.
+ */
+declare function raw(envelope: RawEnvelope): Statement;
+
+/**
+ * `rawValue()` — the value-level escape hatch codegen emits for a stored value it
+ * cannot express through `c.*` / `ref` / `inp` / `withFilters`.
+ *
+ * `Value` is structurally just `{value, tag, filters}`, so an annotated literal
+ * is already byte-exact; this wrapper exists for two reasons a bare literal does
+ * not cover. It types the `tag` as a real `Tag` so the literal also checks out in
+ * a widening position (a `const` declaration in a shared file, not only a
+ * contextually-typed argument), and it makes every non-idiomatic value in a
+ * generated tree greppable by one name.
+ *
+ * Reached via `@xano/sdk/codegen`, alongside `raw()` — same reasoning:
+ * a passthrough should not sit in tab-completion next to `c.text`.
+ */
+
+/**
+ * A stored value as it appears in a bundle. `filters` defaults to none.
+ *
+ * `value` admits the NATIVE scalar spellings as well as the string one, because
+ * the engine stores both and this type describes what a bundle holds rather than
+ * what the SDK writes. The corpus is genuinely mixed — the same tag appears with
+ * a quoted and an unquoted value in one workspace — and codegen echoes whichever
+ * it found. Declaring it `string` alone made a pulled tree fail its own
+ * type-check, which broke every npm script in the scaffold, since
+ * each one runs `tsc --noEmit` first.
+ *
+ * Coercing to the string form at emit would be the other repair. It is the wrong
+ * one for `null`: `normalize()` reconciles a numeric or boolean `value` with its
+ * string spelling, so those compare equal either way, but it does NOT do that for
+ * `null` — so emitting `"null"` for a stored `null` would change the bytes and
+ * fail the round trip.
+ */
+interface RawValueInput {
+    readonly value: string | number | boolean | null;
+    readonly tag: Tag;
+    readonly filters?: readonly FilterXdo[];
+}
+/**
+ * Carry a stored tagged value through verbatim.
+ *
+ * The cast is the point of the escape hatch: `TaggedValue.value` is declared
+ * `string` because that is what every `c.*` constructor writes, while a bundle
+ * may hold a native scalar under the same key. Preserving the stored spelling is
+ * what keeps the round trip exact, so the runtime value is passed through
+ * untouched rather than being coerced to satisfy the declaration.
+ */
+declare function rawValue(v: RawValueInput): TaggedValue;
+
+/** A stored field envelope as it appears in a bundle's `schema[]` / `input[]`. */
+type RawFieldEnvelope = Record<string, unknown>;
+/**
+ * Carry a stored field envelope through encoding unchanged.
+ *
+ * The envelope's own `name` and `type` win over the map key it is attached to,
+ * and a key the envelope does not carry is NOT invented. Preservation is the
+ * whole contract: nothing about the stored shape is rewritten to match its
+ * surroundings, and nothing is added to it.
+ *
+ * @param envelope A stored `schema[]` / `input[]` entry. Must carry `name` and `type`.
+ */
+declare function rawField(envelope: RawFieldEnvelope): FieldDescriptor;
+
+/**
+ * `rawResponse()` — the response-level verbatim passthrough.
+ *
+ * The fourth and last escape hatch, alongside `raw()` for statements,
+ * `rawValue()` for values, and `rawField()` for fields. Together they mean a
+ * pulled workspace never loses data on the way into TypeScript: whatever the
+ * engine stored comes back out unchanged, whether or not this SDK models it.
+ *
+ * It is needed because `encodeResponse` writes `_xsid` and `disabled`
+ * unconditionally at their defaults. No authoring surface reaches either, so a
+ * stored `result[]` item that sets one differently cannot round-trip through the
+ * `response:` field in any form. This carries the whole `result[]` array
+ * instead.
+ *
+ * Reached via `@xano/sdk/codegen`, never from the discoverable authoring
+ * namespace, for the same reason `raw()` stays off `s`.
+ */
+
+/** A stored `result[]` entry as it appears in a bundle. */
+type RawResponseEnvelope = Record<string, unknown>;
+/**
+ * Carry a stored `result[]` array through encoding unchanged.
+ *
+ * A key an item does not carry is **NOT** invented. Preservation is the whole
+ * contract: only key ordering is normalized, and nothing is added.
+ *
+ * That absence rule is not incidental. `raw()` and `rawField()` both shipped
+ * completing absent keys with their defaults, which silently broke their own
+ * passthrough contract — the engine omits keys at their defaults, so filling
+ * them in changes the bytes on the way back. This preserves absence from the
+ * start rather than being fixed into it later.
+ *
+ * @param items Stored `result[]` entries. An empty array means "no response".
+ */
+declare function rawResponse(items: readonly RawResponseEnvelope[]): ResponseDef;
+
+export { type RawEnvelope, type RawFieldEnvelope, type RawResponseEnvelope, type RawValueInput, raw, rawField, rawResponse, rawValue };

package/dist/codegen.js

@@ -0,0 +1,19 @@
+import {
+  raw,
+  rawField,
+  rawValue
+} from "./chunk-FXFV3KU6.js";
+import {
+  rawResponse
+} from "./chunk-AKNCFVKZ.js";
+import "./chunk-YU4HSQW7.js";
+import "./chunk-TTEIYD5P.js";
+import "./chunk-CIMQZRRE.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  raw,
+  rawField,
+  rawResponse,
+  rawValue
+};
+//# sourceMappingURL=codegen.js.map

package/dist/commands-GJMJ4XYZ.js

@@ -0,0 +1,76 @@
+import {
+  COMMANDS,
+  FLAGS,
+  GLOBAL_FLAGS,
+  GUID_STABILITY_NOTE,
+  HELP_GROUP_ORDER,
+  REFUSES_EMPTY_DOC_TOKEN,
+  REFUSES_EMPTY_ENV,
+  acceptsFlag,
+  argValues,
+  flagKey,
+  flagNames,
+  flagRefFor,
+  flagSpec,
+  flagSummary,
+  flagValues,
+  flagValuesClosed,
+  getCommand,
+  getSubcommand,
+  helpDocument,
+  isAuthenticatedCommand,
+  isCommand,
+  liveCommandNames,
+  liveSubcommandNames,
+  publishedFlagValues,
+  renderArgs,
+  selectorSpellings,
+  selectorValues,
+  structuredFlag,
+  tablesCommand,
+  takesProfileFlag,
+  visibleFlags
+} from "./chunk-PTHVMXZI.js";
+import {
+  suggest
+} from "./chunk-UTI5G6OJ.js";
+import "./chunk-2EZ3ZJZZ.js";
+import "./chunk-5ZSO4T2G.js";
+import "./chunk-TFFGOFVZ.js";
+import "./chunk-36JUQZVQ.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  COMMANDS,
+  FLAGS,
+  GLOBAL_FLAGS,
+  GUID_STABILITY_NOTE,
+  HELP_GROUP_ORDER,
+  REFUSES_EMPTY_DOC_TOKEN,
+  REFUSES_EMPTY_ENV,
+  acceptsFlag,
+  argValues,
+  flagKey,
+  flagNames,
+  flagRefFor,
+  flagSpec,
+  flagSummary,
+  flagValues,
+  flagValuesClosed,
+  getCommand,
+  getSubcommand,
+  helpDocument,
+  isAuthenticatedCommand,
+  isCommand,
+  liveCommandNames,
+  liveSubcommandNames,
+  publishedFlagValues,
+  renderArgs,
+  selectorSpellings,
+  selectorValues,
+  structuredFlag,
+  suggest,
+  tablesCommand,
+  takesProfileFlag,
+  visibleFlags
+};
+//# sourceMappingURL=commands-GJMJ4XYZ.js.map