@supalive/core 1.12.0 → 1.13.0

package/dist/schema-DfowI0ip.js

@@ -0,0 +1,134 @@
+import { a as unwrapZodType, n as tableNameToId, r as commitTsCodec } from "./table-id-BJdmctEQ.js";
+import { z as z$1 } from "zod";
+//#region src/db/schema.ts
+function defineComputedField(config) {
+	return config;
+}
+/**
+* Read the effective max length declared on a Zod string (via `.max(n)` /
+* `.length(n)`), unwrapping optional/nullable/default wrappers. Returns
+* undefined for non-strings or unconstrained strings. Mirrors the reader in
+* schema-sql.ts (kept local to avoid a schema <-> schema-sql import cycle) and
+* is used to carry a primary-key id's length into the injected id column so the
+* SQL generator can emit `VARCHAR(n)` instead of an (invalid-as-a-MySQL-PK)
+* `TEXT`.
+*/
+function readZodStringMax(field) {
+	const unwrapped = unwrapZodType(field);
+	if (!(unwrapped instanceof z$1.ZodString)) return void 0;
+	const checks = unwrapped.def?.checks ?? [];
+	let maxLength;
+	for (const check of checks) {
+		const c = check?._zod?.def ?? check;
+		if (c?.check === "length_equals" || c?.check === "size_equals") {
+			const len = c.length ?? c.size;
+			if (typeof len === "number") maxLength = maxLength === void 0 ? len : Math.min(maxLength, len);
+		}
+		if (c?.check === "max_length" || c?.check === "max_size") {
+			const len = c.maximum ?? c.max;
+			if (typeof len === "number") maxLength = maxLength === void 0 ? len : Math.min(maxLength, len);
+		}
+	}
+	return maxLength;
+}
+const schemaRegistry = /* @__PURE__ */ new Map();
+let shouldTrackSchema = false;
+function trackSchema() {
+	shouldTrackSchema = true;
+}
+function getAutoIdCodec(idMeta, userCodec) {
+	if (userCodec) return void 0;
+	const rawType = idMeta.pgType ?? idMeta.mysqlType;
+	if (!rawType) return void 0;
+	const upper = rawType.toUpperCase().replace(/\(.*\)/, "").trim();
+	if ([
+		"BIGINT",
+		"INT8",
+		"SERIAL8"
+	].includes(upper)) return {
+		encode: (v) => BigInt(v),
+		decode: (v) => String(v)
+	};
+	if ([
+		"INTEGER",
+		"INT",
+		"SERIAL",
+		"INT4",
+		"SMALLINT",
+		"INT2"
+	].includes(upper)) return {
+		encode: (v) => Number(v),
+		decode: (v) => String(v)
+	};
+	if ([
+		"DECIMAL",
+		"NUMERIC",
+		"FLOAT",
+		"REAL",
+		"DOUBLE",
+		"FLOAT8",
+		"FLOAT4"
+	].includes(upper)) return {
+		encode: (v) => Number(v),
+		decode: (v) => String(v)
+	};
+	if (upper === "BOOLEAN" || upper === "BOOL" || upper.startsWith("TINYINT") && rawType.toUpperCase().includes("(1)")) return {
+		encode: (v) => v === "true" || v === "1",
+		decode: (v) => String(v)
+	};
+}
+function defineSchema(config) {
+	const columns = {};
+	if (config.columns) Object.assign(columns, {
+		"id": "id",
+		"commitTs": "commit_ts",
+		...config.columns
+	});
+	else {
+		for (const key of Object.keys(config.schema)) columns[key] = key;
+		columns["id"] = "id";
+		columns["commitTs"] = "commit_ts";
+	}
+	const idMeta = {};
+	if ("id" in config.schema) {
+		const userMeta = config.schema.id?.meta?.();
+		if (userMeta) for (const k of Object.keys(userMeta)) {
+			if (k === "primaryKey") continue;
+			idMeta[k] = userMeta[k];
+		}
+	}
+	const userIdMax = "id" in config.schema ? readZodStringMax(config.schema.id) : void 0;
+	const idColumn = userIdMax !== void 0 ? z$1.string().max(userIdMax) : z$1.string();
+	const augmentedShape = {
+		...config.schema,
+		id: idColumn.meta({
+			primaryKey: true,
+			...idMeta
+		}),
+		commitTs: z$1.coerce.bigint()
+	};
+	const userCodecs = config.options?.codecs;
+	const autoIdCodec = getAutoIdCodec(idMeta, userCodecs?.id);
+	const mergedCodecs = {
+		...autoIdCodec ? { id: autoIdCodec } : {},
+		...userCodecs,
+		commitTs: commitTsCodec
+	};
+	const result = {
+		tableId: tableNameToId(config.name),
+		table: config.name,
+		schema: z$1.object(augmentedShape),
+		columnsOptions: {
+			...config.options,
+			codecs: mergedCodecs
+		},
+		columns,
+		indexes: config.indexes ?? []
+	};
+	if (shouldTrackSchema) schemaRegistry.set(config.name, result);
+	return result;
+}
+//#endregion
+export { trackSchema as a, shouldTrackSchema as i, defineSchema as n, schemaRegistry as r, defineComputedField as t };
+
+//# sourceMappingURL=schema-DfowI0ip.js.map

package/dist/schema-DfowI0ip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-DfowI0ip.js","names":["z"],"sources":["../src/db/schema.ts"],"sourcesContent":["import { z, ZodRawShape } from \"zod\";\nimport { commitTsCodec, unwrapZodType } from \"./codec\";\nimport { LiveQueryHandle } from \"../client\";\nimport { tableNameToId } from \"./table-id\";\n\nexport interface ColumnCodec<TData = unknown, TDriver = unknown> {\n    encode?: (value: TData) => TDriver;\n    decode?: (value: TDriver) => TData;\n}\n\n// Constrain a codec's decoded type to match the schema field's inferred type.\n// Without this, `decode` could return any value (e.g. a string outside an enum)\n// and silently override the schema's declared type at the type level.\ntype SchemaCodecField<TSchema extends ZodRawShape, K extends PropertyKey> =\n    K extends keyof TSchema\n    ? TSchema[K] extends z.ZodTypeAny ? z.infer<TSchema[K]> : unknown\n    : K extends keyof BaseSchema\n    ? BaseSchema[K] extends z.ZodTypeAny ? z.infer<BaseSchema[K]> : unknown\n    : unknown;\n\nexport type SchemaCodecs<TSchema extends ZodRawShape> = Partial<{\n    [K in keyof (TSchema & BaseSchema)]: ColumnCodec<SchemaCodecField<TSchema, K>, any>;\n}>;\n\nexport interface SchemaColumnsOptions<TSchema extends ZodRawShape = ZodRawShape> {\n    codecs?: SchemaCodecs<TSchema>;\n}\n\nexport interface SchemaColumnMapping {\n    [key: string]: string;\n}\n\nexport interface DeclarativeIndex {\n    name: string;\n    columns: string[];\n    unique?: boolean;\n    type?: \"btree\" | \"hash\" | \"gin\" | \"gist\" | \"spgist\" | \"brin\";\n    where?: string;\n    using?: string;\n    options?: string;\n    tablespace?: string;\n}\n\nexport type IndexDefinition = string | DeclarativeIndex;\n\nexport interface DefineSchemaConfig<TSchema extends ZodRawShape> {\n    name: string;\n    schema: TSchema;\n    options?: SchemaColumnsOptions<TSchema>;\n    columns?: SchemaColumnMapping;\n    indexes?: IndexDefinition[];\n}\n\n// Tuple-wrap the `undefined` checks so they don't fall through to the\n// object-shape conditionals when consumers compile under `strict: false`\n// (without `strictNullChecks`, `undefined` is assignable to object types and\n// would otherwise match `{ decode: ... }` / `ColumnCodec<...>` with all\n// `infer`s collapsing to `unknown`).\ntype CodecDataType<TCodec, TFallback> =\n    [TCodec] extends [undefined] ? TFallback\n    : TCodec extends { decode: (...args: any[]) => infer TDecoded } ? TDecoded\n    : TCodec extends ColumnCodec<infer TData, unknown> ? TData\n    : TFallback;\n\ntype ZodOutput<TZod> =\n    [TZod] extends [undefined] ? unknown\n    : TZod extends z.ZodTypeAny ? z.infer<TZod>\n    : unknown;\nexport type ComputedDataType<TCodec, TZod> = CodecDataType<TCodec, ZodOutput<TZod>>;\nexport type ComputedCodec<TData, TDriver> = ColumnCodec<TData, TDriver>;\nexport type OverrideField<TObj, TKey extends PropertyKey, TValue> = Omit<TObj, TKey> & { [K in TKey]: TValue };\nexport interface ComputedFieldConfig<\n    TField extends string,\n    TDecoded = unknown,\n    TDriver = unknown,\n    TZodType extends z.ZodTypeAny | undefined = undefined,\n> {\n    field: TField;\n    sql: string;\n    alias?: string;\n    type?: TZodType;\n    codec?: {\n        decode: (value: TDriver) => TDecoded;\n        encode?: (value: TDecoded) => TDriver;\n    };\n}\n\nexport type ComputedField = {\n    field: string;\n    sql: string;\n    alias: string;\n    codec?: ColumnCodec<any, any>;\n};\n\nexport function defineComputedField<\n    TField extends string,\n    TDecoded = unknown,\n    TDriver = unknown,\n    TZodType extends z.ZodTypeAny | undefined = undefined,\n>(\n    config: ComputedFieldConfig<TField, TDecoded, TDriver, TZodType>\n): ComputedFieldConfig<TField, TDecoded, TDriver, TZodType> {\n    return config;\n}\n\nexport type Prettify<T> = { [K in keyof T]: T[K] } & {};\n\ntype ApplySchemaCodecs<TBase, TCodecs> = {\n    [K in keyof TBase]: K extends keyof TCodecs ? CodecDataType<TCodecs[K], TBase[K]> : TBase[K];\n};\n\n// Only apply codecs when `options.codecs` is explicitly provided. Without this\n// guard, the default constraint (`SchemaColumnsOptions<TSchema>`) makes\n// `TOptions[\"codecs\"]` infer as `Partial<{ [K]: ColumnCodec<any, any> }>`,\n// which collapses every field to `any` inside `ApplySchemaCodecs`.\ntype ResolveSchemaType<\n    TSchema extends ZodRawShape,\n    TOptions extends SchemaColumnsOptions<TSchema>\n> = TOptions extends { codecs: infer TCodecs }\n    ? Prettify<ApplySchemaCodecs<z.infer<z.ZodObject<TSchema & BaseSchema>>, TCodecs>>\n    : Prettify<z.infer<z.ZodObject<TSchema & BaseSchema>>>;\n\n// Helper to detect if a Zod type is optional or nullable\ntype IsOptionalField<T> =\n    T extends z.ZodOptional<any> ? true :\n    T extends z.ZodNullable<any> ? true :\n    T extends z.ZodDefault<any> ? true :\n    false;\n\n// Split schema keys into required vs optional\ntype OptionalKeys<TZod extends ZodRawShape> = {\n    [K in keyof TZod]: IsOptionalField<TZod[K]> extends true ? K : never\n}[keyof TZod];\n\ntype RequiredKeys<TZod extends ZodRawShape> = {\n    [K in keyof TZod]: IsOptionalField<TZod[K]> extends true ? never : K\n}[keyof TZod];\n\n// Add a base shape type that all schemas will include\ntype BaseSchema = {\n    id: z.ZodString;\n    commitTs: z.ZodCoercedBigInt;\n};\n\n/**\n * Read the effective max length declared on a Zod string (via `.max(n)` /\n * `.length(n)`), unwrapping optional/nullable/default wrappers. Returns\n * undefined for non-strings or unconstrained strings. Mirrors the reader in\n * schema-sql.ts (kept local to avoid a schema <-> schema-sql import cycle) and\n * is used to carry a primary-key id's length into the injected id column so the\n * SQL generator can emit `VARCHAR(n)` instead of an (invalid-as-a-MySQL-PK)\n * `TEXT`.\n */\nfunction readZodStringMax(field: unknown): number | undefined {\n    const unwrapped = unwrapZodType(field);\n    if (!(unwrapped instanceof z.ZodString)) return undefined;\n\n    const checks = unwrapped.def?.checks ?? [];\n    let maxLength: number | undefined;\n    for (const check of checks) {\n        const c = check?._zod?.def ?? check;\n        if (c?.check === \"length_equals\" || c?.check === \"size_equals\") {\n            const len = (c as any).length ?? (c as any).size;\n            if (typeof len === \"number\") maxLength = maxLength === undefined ? len : Math.min(maxLength, len);\n        }\n        if (c?.check === \"max_length\" || c?.check === \"max_size\") {\n            const len = (c as any).maximum ?? (c as any).max;\n            if (typeof len === \"number\") maxLength = maxLength === undefined ? len : Math.min(maxLength, len);\n        }\n    }\n    return maxLength;\n}\n\nexport const schemaRegistry = new Map<string, SchemaDefinition<string, any, any>>();\nexport let shouldTrackSchema = false;\n\nexport function trackSchema(): void {\n    shouldTrackSchema = true;\n}\n\nfunction getAutoIdCodec(idMeta: Record<string, unknown>, userCodec: unknown): ColumnCodec<any, any> | undefined {\n    if (userCodec) return undefined;\n    const rawType = (idMeta.pgType as string | undefined) ?? (idMeta.mysqlType as string | undefined);\n    if (!rawType) return undefined;\n\n    const upper = rawType.toUpperCase().replace(/\\(.*\\)/, \"\").trim();\n    if ([\"BIGINT\", \"INT8\", \"SERIAL8\"].includes(upper)) {\n        return {\n            encode: (v: string) => BigInt(v),\n            decode: (v: unknown) => String(v),\n        };\n    }\n    if ([\"INTEGER\", \"INT\", \"SERIAL\", \"INT4\", \"SMALLINT\", \"INT2\"].includes(upper)) {\n        return {\n            encode: (v: string) => Number(v),\n            decode: (v: unknown) => String(v),\n        };\n    }\n    if ([\"DECIMAL\", \"NUMERIC\", \"FLOAT\", \"REAL\", \"DOUBLE\", \"FLOAT8\", \"FLOAT4\"].includes(upper)) {\n        return {\n            encode: (v: string) => Number(v),\n            decode: (v: unknown) => String(v),\n        };\n    }\n    if (upper === \"BOOLEAN\" || upper === \"BOOL\" || (upper.startsWith(\"TINYINT\") && rawType.toUpperCase().includes(\"(1)\"))) {\n        return {\n            encode: (v: string) => v === \"true\" || v === \"1\",\n            decode: (v: unknown) => String(v),\n        };\n    }\n    return undefined;\n}\n\nexport function defineSchema<\n    TSchema extends ZodRawShape,\n    TName extends string,\n    TOptions extends SchemaColumnsOptions<TSchema> = SchemaColumnsOptions<TSchema>\n>(\n    config: DefineSchemaConfig<TSchema> & { name: TName; options?: TOptions }\n): SchemaDefinition<TName, Prettify<TSchema & BaseSchema>, ResolveSchemaType<TSchema, TOptions>> {\n    const columns: Record<string, string> = {};\n\n    if (config.columns) {\n        Object.assign(columns, { 'id': 'id', 'commitTs': 'commit_ts', ...config.columns });\n    } else {\n        // Default: use field name as column name\n        for (const key of Object.keys(config.schema)) {\n            columns[key] = key;\n        }\n        columns['id'] = 'id';\n        columns['commitTs'] = 'commit_ts';\n    }\n\n    // Preserve user's id meta (pgType, mysqlType, etc.) so the SQL generator\n    // can emit the correct raw type. primaryKey is always forced true.\n    const idMeta: Record<string, unknown> = {};\n    if (\"id\" in config.schema) {\n        const userMeta = (config.schema.id as any)?.meta?.();\n        if (userMeta) {\n            for (const k of Object.keys(userMeta)) {\n                if (k === \"primaryKey\") continue; // always forced true\n                idMeta[k] = userMeta[k];\n            }\n        }\n    }\n\n    // Preserve the user's id length constraint (`zodPrimaryIdColumn().max(32)`)\n    // so the SQL generator emits `VARCHAR(n)`. `.max()` is a Zod *check*, not\n    // metadata, so it isn't captured by `idMeta` above and must be re-applied to\n    // the injected id — otherwise the PK renders as `TEXT`, which MySQL cannot\n    // use as a primary key.\n    const userIdMax = \"id\" in config.schema ? readZodStringMax(config.schema.id) : undefined;\n    const idColumn = userIdMax !== undefined ? z.string().max(userIdMax) : z.string();\n\n    // Merge id/commitTs into the Zod schema, user-defined fields win for everything else,\n    // but id/commitTs are always forced to their correct types\n    const augmentedShape = {\n        ...config.schema,\n        // always string, even if user defined it differently\n        id: idColumn.meta({ primaryKey: true, ...idMeta }),\n        // always bigint, mapped to commit_ts column\n        commitTs: z.coerce.bigint(),\n    };\n\n    const userCodecs = config.options?.codecs;\n    const autoIdCodec = getAutoIdCodec(idMeta, userCodecs?.id);\n    const mergedCodecs = {\n        ...(autoIdCodec ? { id: autoIdCodec } : {}),\n        ...userCodecs,\n        commitTs: commitTsCodec,\n    };\n\n    const result = {\n        tableId: tableNameToId(config.name),\n        table: config.name,\n        schema: z.object(augmentedShape),\n        columnsOptions: {\n            ...config.options,\n            codecs: mergedCodecs,\n        },\n        columns,\n        indexes: config.indexes ?? [],\n    } as SchemaDefinition<TName, TSchema & BaseSchema, ResolveSchemaType<TSchema, TOptions>>;\n\n    if (shouldTrackSchema) {\n        schemaRegistry.set(config.name, result);\n    }\n\n    return result\n}\n\n// tableNameToId now lives in ./table-id (leaf module, also home to the memoized\n// tableIdOf). Re-exported here so existing `from \"./schema\"` imports still resolve.\nexport { tableNameToId };\n\n// Stored codec map is intentionally loose: the strict per-field constraint is\n// enforced on the input (`DefineSchemaConfig.options`), but storing the strict\n// type here would break variance when assigning a specific schema to a generic\n// `SchemaDefinition<string, ZodRawShape>` constraint (ColumnCodec.encode is\n// contravariant in its data type).\nexport interface StoredSchemaColumnsOptions {\n    codecs?: Record<string, ColumnCodec<any, any>>;\n}\n\nexport interface SchemaDefinition<\n    TTable extends string,\n    TZod extends ZodRawShape,\n    TData = z.infer<z.ZodObject<TZod>>\n> {\n    tableId: Uint8Array;\n    table: TTable;\n    schema: z.ZodObject<TZod>;\n    columnsOptions: StoredSchemaColumnsOptions;\n    columns: Record<string, string>;\n    indexes: IndexDefinition[];\n    _dataType?: TData;\n}\n\nexport type InferSchema<T extends SchemaDefinition<string, ZodRawShape, any>> =\n    T extends SchemaDefinition<string, ZodRawShape, infer TData> ? TData : never;\n\nexport type InsertData<T extends SchemaDefinition<string, ZodRawShape, any>> =\n    T extends SchemaDefinition<string, infer TZod, infer TData>\n    ? {\n        [K in RequiredKeys<TZod> as K extends \"id\" | \"commitTs\" ? never : K]:\n        Extract<K, string> extends keyof TData ? TData[Extract<K, string>] : never\n    } & {\n        [K in OptionalKeys<TZod> as K extends \"id\" | \"commitTs\" ? never : K]?:\n        Extract<K, string> extends keyof TData ? TData[Extract<K, string>] : never\n    }\n    : never;\n\nexport interface Model {\n    table: string;\n    tableId: Uint8Array,\n    columns: Record<string, string>;\n    reverseColumns: Record<string, string>;\n    types: Record<string, string>;\n    codecs: Record<string, ColumnCodec<any, any>>;\n}\n\n\ntype MaybePromise<T> = T | Promise<T>;\n\nexport type ReturnLiveQuery<\n    TLiveQueryFn extends (...args: any[]) => MaybePromise<LiveQueryHandle<any>>\n> =\n    Awaited<ReturnType<TLiveQueryFn>> extends LiveQueryHandle<infer T>\n    ? T\n    : never;\n\nexport type ReturnQuery<TQueryFn extends (...args: any[]) => any> =\n    Awaited<ReturnType<TQueryFn>>;\n\nexport type QueryArgs<TQueryFn extends (...args: any[]) => any> =\n    Parameters<TQueryFn>[0];\n\nexport type MutationArgs<TMutationFn extends (...args: any[]) => any> =\n    Parameters<TMutationFn>[0];\n\nexport type ActionArgs<TActionFn extends (...args: any[]) => any> =\n    Parameters<TActionFn>[0];"],"mappings":";;;AA8FA,SAAgB,oBAMZ,QACwD;CACxD,OAAO;AACX;;;;;;;;;;AAkDA,SAAS,iBAAiB,OAAoC;CAC1D,MAAM,YAAY,cAAc,KAAK;CACrC,IAAI,EAAE,qBAAqBA,IAAE,YAAY,OAAO,KAAA;CAEhD,MAAM,SAAS,UAAU,KAAK,UAAU,CAAC;CACzC,IAAI;CACJ,KAAK,MAAM,SAAS,QAAQ;EACxB,MAAM,IAAI,OAAO,MAAM,OAAO;EAC9B,IAAI,GAAG,UAAU,mBAAmB,GAAG,UAAU,eAAe;GAC5D,MAAM,MAAO,EAAU,UAAW,EAAU;GAC5C,IAAI,OAAO,QAAQ,UAAU,YAAY,cAAc,KAAA,IAAY,MAAM,KAAK,IAAI,WAAW,GAAG;EACpG;EACA,IAAI,GAAG,UAAU,gBAAgB,GAAG,UAAU,YAAY;GACtD,MAAM,MAAO,EAAU,WAAY,EAAU;GAC7C,IAAI,OAAO,QAAQ,UAAU,YAAY,cAAc,KAAA,IAAY,MAAM,KAAK,IAAI,WAAW,GAAG;EACpG;CACJ;CACA,OAAO;AACX;AAEA,MAAa,iCAAiB,IAAI,IAAgD;AAClF,IAAW,oBAAoB;AAE/B,SAAgB,cAAoB;CAChC,oBAAoB;AACxB;AAEA,SAAS,eAAe,QAAiC,WAAuD;CAC5G,IAAI,WAAW,OAAO,KAAA;CACtB,MAAM,UAAW,OAAO,UAAkC,OAAO;CACjE,IAAI,CAAC,SAAS,OAAO,KAAA;CAErB,MAAM,QAAQ,QAAQ,YAAY,CAAC,CAAC,QAAQ,UAAU,EAAE,CAAC,CAAC,KAAK;CAC/D,IAAI;EAAC;EAAU;EAAQ;CAAS,CAAC,CAAC,SAAS,KAAK,GAC5C,OAAO;EACH,SAAS,MAAc,OAAO,CAAC;EAC/B,SAAS,MAAe,OAAO,CAAC;CACpC;CAEJ,IAAI;EAAC;EAAW;EAAO;EAAU;EAAQ;EAAY;CAAM,CAAC,CAAC,SAAS,KAAK,GACvE,OAAO;EACH,SAAS,MAAc,OAAO,CAAC;EAC/B,SAAS,MAAe,OAAO,CAAC;CACpC;CAEJ,IAAI;EAAC;EAAW;EAAW;EAAS;EAAQ;EAAU;EAAU;CAAQ,CAAC,CAAC,SAAS,KAAK,GACpF,OAAO;EACH,SAAS,MAAc,OAAO,CAAC;EAC/B,SAAS,MAAe,OAAO,CAAC;CACpC;CAEJ,IAAI,UAAU,aAAa,UAAU,UAAW,MAAM,WAAW,SAAS,KAAK,QAAQ,YAAY,CAAC,CAAC,SAAS,KAAK,GAC/G,OAAO;EACH,SAAS,MAAc,MAAM,UAAU,MAAM;EAC7C,SAAS,MAAe,OAAO,CAAC;CACpC;AAGR;AAEA,SAAgB,aAKZ,QAC6F;CAC7F,MAAM,UAAkC,CAAC;CAEzC,IAAI,OAAO,SACP,OAAO,OAAO,SAAS;EAAE,MAAM;EAAM,YAAY;EAAa,GAAG,OAAO;CAAQ,CAAC;MAC9E;EAEH,KAAK,MAAM,OAAO,OAAO,KAAK,OAAO,MAAM,GACvC,QAAQ,OAAO;EAEnB,QAAQ,QAAQ;EAChB,QAAQ,cAAc;CAC1B;CAIA,MAAM,SAAkC,CAAC;CACzC,IAAI,QAAQ,OAAO,QAAQ;EACvB,MAAM,WAAY,OAAO,OAAO,IAAY,OAAO;EACnD,IAAI,UACA,KAAK,MAAM,KAAK,OAAO,KAAK,QAAQ,GAAG;GACnC,IAAI,MAAM,cAAc;GACxB,OAAO,KAAK,SAAS;EACzB;CAER;CAOA,MAAM,YAAY,QAAQ,OAAO,SAAS,iBAAiB,OAAO,OAAO,EAAE,IAAI,KAAA;CAC/E,MAAM,WAAW,cAAc,KAAA,IAAYA,IAAE,OAAO,CAAC,CAAC,IAAI,SAAS,IAAIA,IAAE,OAAO;CAIhF,MAAM,iBAAiB;EACnB,GAAG,OAAO;EAEV,IAAI,SAAS,KAAK;GAAE,YAAY;GAAM,GAAG;EAAO,CAAC;EAEjD,UAAUA,IAAE,OAAO,OAAO;CAC9B;CAEA,MAAM,aAAa,OAAO,SAAS;CACnC,MAAM,cAAc,eAAe,QAAQ,YAAY,EAAE;CACzD,MAAM,eAAe;EACjB,GAAI,cAAc,EAAE,IAAI,YAAY,IAAI,CAAC;EACzC,GAAG;EACH,UAAU;CACd;CAEA,MAAM,SAAS;EACX,SAAS,cAAc,OAAO,IAAI;EAClC,OAAO,OAAO;EACd,QAAQA,IAAE,OAAO,cAAc;EAC/B,gBAAgB;GACZ,GAAG,OAAO;GACV,QAAQ;EACZ;EACA;EACA,SAAS,OAAO,WAAW,CAAC;CAChC;CAEA,IAAI,mBACA,eAAe,IAAI,OAAO,MAAM,MAAM;CAG1C,OAAO;AACX"}

package/dist/schema-fKldWzwc.js

@@ -0,0 +1,134 @@
+import { a as unwrapZodType, n as tableNameToId, r as commitTsCodec } from "./table-id-x9y1eHUr.js";
+import { z as z$1 } from "zod";
+//#region src/db/schema.ts
+function defineComputedField(config) {
+	return config;
+}
+/**
+* Read the effective max length declared on a Zod string (via `.max(n)` /
+* `.length(n)`), unwrapping optional/nullable/default wrappers. Returns
+* undefined for non-strings or unconstrained strings. Mirrors the reader in
+* schema-sql.ts (kept local to avoid a schema <-> schema-sql import cycle) and
+* is used to carry a primary-key id's length into the injected id column so the
+* SQL generator can emit `VARCHAR(n)` instead of an (invalid-as-a-MySQL-PK)
+* `TEXT`.
+*/
+function readZodStringMax(field) {
+	const unwrapped = unwrapZodType(field);
+	if (!(unwrapped instanceof z$1.ZodString)) return void 0;
+	const checks = unwrapped.def?.checks ?? [];
+	let maxLength;
+	for (const check of checks) {
+		const c = check?._zod?.def ?? check?.def ?? check;
+		if (c?.check === "length_equals" || c?.check === "size_equals") {
+			const len = c.length ?? c.size;
+			if (typeof len === "number") maxLength = maxLength === void 0 ? len : Math.min(maxLength, len);
+		}
+		if (c?.check === "max_length" || c?.check === "max_size") {
+			const len = c.maximum ?? c.max;
+			if (typeof len === "number") maxLength = maxLength === void 0 ? len : Math.min(maxLength, len);
+		}
+	}
+	return maxLength;
+}
+const schemaRegistry = /* @__PURE__ */ new Map();
+let shouldTrackSchema = false;
+function trackSchema() {
+	shouldTrackSchema = true;
+}
+function getAutoIdCodec(idMeta, userCodec) {
+	if (userCodec) return void 0;
+	const rawType = idMeta.pgType ?? idMeta.mysqlType;
+	if (!rawType) return void 0;
+	const upper = rawType.toUpperCase().replace(/\(.*\)/, "").trim();
+	if ([
+		"BIGINT",
+		"INT8",
+		"SERIAL8"
+	].includes(upper)) return {
+		encode: (v) => BigInt(v),
+		decode: (v) => String(v)
+	};
+	if ([
+		"INTEGER",
+		"INT",
+		"SERIAL",
+		"INT4",
+		"SMALLINT",
+		"INT2"
+	].includes(upper)) return {
+		encode: (v) => Number(v),
+		decode: (v) => String(v)
+	};
+	if ([
+		"DECIMAL",
+		"NUMERIC",
+		"FLOAT",
+		"REAL",
+		"DOUBLE",
+		"FLOAT8",
+		"FLOAT4"
+	].includes(upper)) return {
+		encode: (v) => Number(v),
+		decode: (v) => String(v)
+	};
+	if (upper === "BOOLEAN" || upper === "BOOL" || upper.startsWith("TINYINT") && rawType.toUpperCase().includes("(1)")) return {
+		encode: (v) => v === "true" || v === "1",
+		decode: (v) => String(v)
+	};
+}
+function defineSchema(config) {
+	const columns = {};
+	if (config.columns) Object.assign(columns, {
+		"id": "id",
+		"commitTs": "commit_ts",
+		...config.columns
+	});
+	else {
+		for (const key of Object.keys(config.schema)) columns[key] = key;
+		columns["id"] = "id";
+		columns["commitTs"] = "commit_ts";
+	}
+	const idMeta = {};
+	if ("id" in config.schema) {
+		const userMeta = config.schema.id?.meta?.();
+		if (userMeta) for (const k of Object.keys(userMeta)) {
+			if (k === "primaryKey") continue;
+			idMeta[k] = userMeta[k];
+		}
+	}
+	const userIdMax = "id" in config.schema ? readZodStringMax(config.schema.id) : void 0;
+	const idColumn = userIdMax !== void 0 ? z$1.string().max(userIdMax) : z$1.string();
+	const augmentedShape = {
+		...config.schema,
+		id: idColumn.meta({
+			primaryKey: true,
+			...idMeta
+		}),
+		commitTs: z$1.coerce.bigint()
+	};
+	const userCodecs = config.options?.codecs;
+	const autoIdCodec = getAutoIdCodec(idMeta, userCodecs?.id);
+	const mergedCodecs = {
+		...autoIdCodec ? { id: autoIdCodec } : {},
+		...userCodecs,
+		commitTs: commitTsCodec
+	};
+	const result = {
+		tableId: tableNameToId(config.name),
+		table: config.name,
+		schema: z$1.object(augmentedShape),
+		columnsOptions: {
+			...config.options,
+			codecs: mergedCodecs
+		},
+		columns,
+		indexes: config.indexes ?? []
+	};
+	if (shouldTrackSchema) schemaRegistry.set(config.name, result);
+	return result;
+}
+//#endregion
+export { trackSchema as a, shouldTrackSchema as i, defineSchema as n, schemaRegistry as r, defineComputedField as t };
+
+//# sourceMappingURL=schema-fKldWzwc.js.map

package/dist/schema-fKldWzwc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-fKldWzwc.js","names":["z"],"sources":["../src/db/schema.ts"],"sourcesContent":["import { z, ZodRawShape } from \"zod\";\nimport { commitTsCodec, unwrapZodType } from \"./codec\";\nimport { LiveQueryHandle } from \"../client\";\nimport { tableNameToId } from \"./table-id\";\n\nexport interface ColumnCodec<TData = unknown, TDriver = unknown> {\n    encode?: (value: TData) => TDriver;\n    decode?: (value: TDriver) => TData;\n}\n\n// Constrain a codec's decoded type to match the schema field's inferred type.\n// Without this, `decode` could return any value (e.g. a string outside an enum)\n// and silently override the schema's declared type at the type level.\ntype SchemaCodecField<TSchema extends ZodRawShape, K extends PropertyKey> =\n    K extends keyof TSchema\n    ? TSchema[K] extends z.ZodTypeAny ? z.infer<TSchema[K]> : unknown\n    : K extends keyof BaseSchema\n    ? BaseSchema[K] extends z.ZodTypeAny ? z.infer<BaseSchema[K]> : unknown\n    : unknown;\n\nexport type SchemaCodecs<TSchema extends ZodRawShape> = Partial<{\n    [K in keyof (TSchema & BaseSchema)]: ColumnCodec<SchemaCodecField<TSchema, K>, any>;\n}>;\n\nexport interface SchemaColumnsOptions<TSchema extends ZodRawShape = ZodRawShape> {\n    codecs?: SchemaCodecs<TSchema>;\n}\n\nexport interface SchemaColumnMapping {\n    [key: string]: string;\n}\n\nexport interface DeclarativeIndex {\n    name: string;\n    columns: string[];\n    unique?: boolean;\n    type?: \"btree\" | \"hash\" | \"gin\" | \"gist\" | \"spgist\" | \"brin\";\n    where?: string;\n    using?: string;\n    options?: string;\n    tablespace?: string;\n}\n\nexport type IndexDefinition = string | DeclarativeIndex;\n\nexport interface DefineSchemaConfig<TSchema extends ZodRawShape> {\n    name: string;\n    schema: TSchema;\n    options?: SchemaColumnsOptions<TSchema>;\n    columns?: SchemaColumnMapping;\n    indexes?: IndexDefinition[];\n}\n\n// Tuple-wrap the `undefined` checks so they don't fall through to the\n// object-shape conditionals when consumers compile under `strict: false`\n// (without `strictNullChecks`, `undefined` is assignable to object types and\n// would otherwise match `{ decode: ... }` / `ColumnCodec<...>` with all\n// `infer`s collapsing to `unknown`).\ntype CodecDataType<TCodec, TFallback> =\n    [TCodec] extends [undefined] ? TFallback\n    : TCodec extends { decode: (...args: any[]) => infer TDecoded } ? TDecoded\n    : TCodec extends ColumnCodec<infer TData, unknown> ? TData\n    : TFallback;\n\ntype ZodOutput<TZod> =\n    [TZod] extends [undefined] ? unknown\n    : TZod extends z.ZodTypeAny ? z.infer<TZod>\n    : unknown;\nexport type ComputedDataType<TCodec, TZod> = CodecDataType<TCodec, ZodOutput<TZod>>;\nexport type ComputedCodec<TData, TDriver> = ColumnCodec<TData, TDriver>;\nexport type OverrideField<TObj, TKey extends PropertyKey, TValue> = Omit<TObj, TKey> & { [K in TKey]: TValue };\nexport interface ComputedFieldConfig<\n    TField extends string,\n    TDecoded = unknown,\n    TDriver = unknown,\n    TZodType extends z.ZodTypeAny | undefined = undefined,\n> {\n    field: TField;\n    sql: string;\n    alias?: string;\n    type?: TZodType;\n    codec?: {\n        decode: (value: TDriver) => TDecoded;\n        encode?: (value: TDecoded) => TDriver;\n    };\n}\n\nexport type ComputedField = {\n    field: string;\n    sql: string;\n    alias: string;\n    codec?: ColumnCodec<any, any>;\n};\n\nexport function defineComputedField<\n    TField extends string,\n    TDecoded = unknown,\n    TDriver = unknown,\n    TZodType extends z.ZodTypeAny | undefined = undefined,\n>(\n    config: ComputedFieldConfig<TField, TDecoded, TDriver, TZodType>\n): ComputedFieldConfig<TField, TDecoded, TDriver, TZodType> {\n    return config;\n}\n\nexport type Prettify<T> = { [K in keyof T]: T[K] } & {};\n\ntype ApplySchemaCodecs<TBase, TCodecs> = {\n    [K in keyof TBase]: K extends keyof TCodecs ? CodecDataType<TCodecs[K], TBase[K]> : TBase[K];\n};\n\n// Only apply codecs when `options.codecs` is explicitly provided. Without this\n// guard, the default constraint (`SchemaColumnsOptions<TSchema>`) makes\n// `TOptions[\"codecs\"]` infer as `Partial<{ [K]: ColumnCodec<any, any> }>`,\n// which collapses every field to `any` inside `ApplySchemaCodecs`.\ntype ResolveSchemaType<\n    TSchema extends ZodRawShape,\n    TOptions extends SchemaColumnsOptions<TSchema>\n> = TOptions extends { codecs: infer TCodecs }\n    ? Prettify<ApplySchemaCodecs<z.infer<z.ZodObject<TSchema & BaseSchema>>, TCodecs>>\n    : Prettify<z.infer<z.ZodObject<TSchema & BaseSchema>>>;\n\n// Helper to detect if a Zod type is optional or nullable\ntype IsOptionalField<T> =\n    T extends z.ZodOptional<any> ? true :\n    T extends z.ZodNullable<any> ? true :\n    T extends z.ZodDefault<any> ? true :\n    false;\n\n// Split schema keys into required vs optional\ntype OptionalKeys<TZod extends ZodRawShape> = {\n    [K in keyof TZod]: IsOptionalField<TZod[K]> extends true ? K : never\n}[keyof TZod];\n\ntype RequiredKeys<TZod extends ZodRawShape> = {\n    [K in keyof TZod]: IsOptionalField<TZod[K]> extends true ? never : K\n}[keyof TZod];\n\n// Add a base shape type that all schemas will include\ntype BaseSchema = {\n    id: z.ZodString;\n    commitTs: z.ZodCoercedBigInt;\n};\n\n/**\n * Read the effective max length declared on a Zod string (via `.max(n)` /\n * `.length(n)`), unwrapping optional/nullable/default wrappers. Returns\n * undefined for non-strings or unconstrained strings. Mirrors the reader in\n * schema-sql.ts (kept local to avoid a schema <-> schema-sql import cycle) and\n * is used to carry a primary-key id's length into the injected id column so the\n * SQL generator can emit `VARCHAR(n)` instead of an (invalid-as-a-MySQL-PK)\n * `TEXT`.\n */\nfunction readZodStringMax(field: unknown): number | undefined {\n    const unwrapped = unwrapZodType(field);\n    if (!(unwrapped instanceof z.ZodString)) return undefined;\n\n    const checks: any[] = (unwrapped as any).def?.checks ?? [];\n    let maxLength: number | undefined;\n    for (const check of checks) {\n        const c = check?._zod?.def ?? check?.def ?? check;\n        if (c?.check === \"length_equals\" || c?.check === \"size_equals\") {\n            const len = c.length ?? c.size;\n            if (typeof len === \"number\") maxLength = maxLength === undefined ? len : Math.min(maxLength, len);\n        }\n        if (c?.check === \"max_length\" || c?.check === \"max_size\") {\n            const len = c.maximum ?? c.max;\n            if (typeof len === \"number\") maxLength = maxLength === undefined ? len : Math.min(maxLength, len);\n        }\n    }\n    return maxLength;\n}\n\nexport const schemaRegistry = new Map<string, SchemaDefinition<string, any, any>>();\nexport let shouldTrackSchema = false;\n\nexport function trackSchema(): void {\n    shouldTrackSchema = true;\n}\n\nfunction getAutoIdCodec(idMeta: Record<string, unknown>, userCodec: unknown): ColumnCodec<any, any> | undefined {\n    if (userCodec) return undefined;\n    const rawType = (idMeta.pgType as string | undefined) ?? (idMeta.mysqlType as string | undefined);\n    if (!rawType) return undefined;\n\n    const upper = rawType.toUpperCase().replace(/\\(.*\\)/, \"\").trim();\n    if ([\"BIGINT\", \"INT8\", \"SERIAL8\"].includes(upper)) {\n        return {\n            encode: (v: string) => BigInt(v),\n            decode: (v: unknown) => String(v),\n        };\n    }\n    if ([\"INTEGER\", \"INT\", \"SERIAL\", \"INT4\", \"SMALLINT\", \"INT2\"].includes(upper)) {\n        return {\n            encode: (v: string) => Number(v),\n            decode: (v: unknown) => String(v),\n        };\n    }\n    if ([\"DECIMAL\", \"NUMERIC\", \"FLOAT\", \"REAL\", \"DOUBLE\", \"FLOAT8\", \"FLOAT4\"].includes(upper)) {\n        return {\n            encode: (v: string) => Number(v),\n            decode: (v: unknown) => String(v),\n        };\n    }\n    if (upper === \"BOOLEAN\" || upper === \"BOOL\" || (upper.startsWith(\"TINYINT\") && rawType.toUpperCase().includes(\"(1)\"))) {\n        return {\n            encode: (v: string) => v === \"true\" || v === \"1\",\n            decode: (v: unknown) => String(v),\n        };\n    }\n    return undefined;\n}\n\nexport function defineSchema<\n    TSchema extends ZodRawShape,\n    TName extends string,\n    TOptions extends SchemaColumnsOptions<TSchema> = SchemaColumnsOptions<TSchema>\n>(\n    config: DefineSchemaConfig<TSchema> & { name: TName; options?: TOptions }\n): SchemaDefinition<TName, Prettify<TSchema & BaseSchema>, ResolveSchemaType<TSchema, TOptions>> {\n    const columns: Record<string, string> = {};\n\n    if (config.columns) {\n        Object.assign(columns, { 'id': 'id', 'commitTs': 'commit_ts', ...config.columns });\n    } else {\n        // Default: use field name as column name\n        for (const key of Object.keys(config.schema)) {\n            columns[key] = key;\n        }\n        columns['id'] = 'id';\n        columns['commitTs'] = 'commit_ts';\n    }\n\n    // Preserve user's id meta (pgType, mysqlType, etc.) so the SQL generator\n    // can emit the correct raw type. primaryKey is always forced true.\n    const idMeta: Record<string, unknown> = {};\n    if (\"id\" in config.schema) {\n        const userMeta = (config.schema.id as any)?.meta?.();\n        if (userMeta) {\n            for (const k of Object.keys(userMeta)) {\n                if (k === \"primaryKey\") continue; // always forced true\n                idMeta[k] = userMeta[k];\n            }\n        }\n    }\n\n    // Preserve the user's id length constraint (`zodPrimaryIdColumn().max(32)`)\n    // so the SQL generator emits `VARCHAR(n)`. `.max()` is a Zod *check*, not\n    // metadata, so it isn't captured by `idMeta` above and must be re-applied to\n    // the injected id — otherwise the PK renders as `TEXT`, which MySQL cannot\n    // use as a primary key.\n    const userIdMax = \"id\" in config.schema ? readZodStringMax(config.schema.id) : undefined;\n    const idColumn = userIdMax !== undefined ? z.string().max(userIdMax) : z.string();\n\n    // Merge id/commitTs into the Zod schema, user-defined fields win for everything else,\n    // but id/commitTs are always forced to their correct types\n    const augmentedShape = {\n        ...config.schema,\n        // always string, even if user defined it differently\n        id: idColumn.meta({ primaryKey: true, ...idMeta }),\n        // always bigint, mapped to commit_ts column\n        commitTs: z.coerce.bigint(),\n    };\n\n    const userCodecs = config.options?.codecs;\n    const autoIdCodec = getAutoIdCodec(idMeta, userCodecs?.id);\n    const mergedCodecs = {\n        ...(autoIdCodec ? { id: autoIdCodec } : {}),\n        ...userCodecs,\n        commitTs: commitTsCodec,\n    };\n\n    const result = {\n        tableId: tableNameToId(config.name),\n        table: config.name,\n        schema: z.object(augmentedShape),\n        columnsOptions: {\n            ...config.options,\n            codecs: mergedCodecs,\n        },\n        columns,\n        indexes: config.indexes ?? [],\n    } as SchemaDefinition<TName, TSchema & BaseSchema, ResolveSchemaType<TSchema, TOptions>>;\n\n    if (shouldTrackSchema) {\n        schemaRegistry.set(config.name, result);\n    }\n\n    return result\n}\n\n// tableNameToId now lives in ./table-id (leaf module, also home to the memoized\n// tableIdOf). Re-exported here so existing `from \"./schema\"` imports still resolve.\nexport { tableNameToId };\n\n// Stored codec map is intentionally loose: the strict per-field constraint is\n// enforced on the input (`DefineSchemaConfig.options`), but storing the strict\n// type here would break variance when assigning a specific schema to a generic\n// `SchemaDefinition<string, ZodRawShape>` constraint (ColumnCodec.encode is\n// contravariant in its data type).\nexport interface StoredSchemaColumnsOptions {\n    codecs?: Record<string, ColumnCodec<any, any>>;\n}\n\nexport interface SchemaDefinition<\n    TTable extends string,\n    TZod extends ZodRawShape,\n    TData = z.infer<z.ZodObject<TZod>>\n> {\n    tableId: Uint8Array;\n    table: TTable;\n    schema: z.ZodObject<TZod>;\n    columnsOptions: StoredSchemaColumnsOptions;\n    columns: Record<string, string>;\n    indexes: IndexDefinition[];\n    _dataType?: TData;\n}\n\nexport type InferSchema<T extends SchemaDefinition<string, ZodRawShape, any>> =\n    T extends SchemaDefinition<string, ZodRawShape, infer TData> ? TData : never;\n\nexport type InsertData<T extends SchemaDefinition<string, ZodRawShape, any>> =\n    T extends SchemaDefinition<string, infer TZod, infer TData>\n    ? {\n        [K in RequiredKeys<TZod> as K extends \"id\" | \"commitTs\" ? never : K]:\n        Extract<K, string> extends keyof TData ? TData[Extract<K, string>] : never\n    } & {\n        [K in OptionalKeys<TZod> as K extends \"id\" | \"commitTs\" ? never : K]?:\n        Extract<K, string> extends keyof TData ? TData[Extract<K, string>] : never\n    }\n    : never;\n\nexport interface Model {\n    table: string;\n    tableId: Uint8Array,\n    columns: Record<string, string>;\n    reverseColumns: Record<string, string>;\n    types: Record<string, string>;\n    codecs: Record<string, ColumnCodec<any, any>>;\n}\n\n\ntype MaybePromise<T> = T | Promise<T>;\n\nexport type ReturnLiveQuery<\n    TLiveQueryFn extends (...args: any[]) => MaybePromise<LiveQueryHandle<any>>\n> =\n    Awaited<ReturnType<TLiveQueryFn>> extends LiveQueryHandle<infer T>\n    ? T\n    : never;\n\nexport type ReturnQuery<TQueryFn extends (...args: any[]) => any> =\n    Awaited<ReturnType<TQueryFn>>;\n\nexport type QueryArgs<TQueryFn extends (...args: any[]) => any> =\n    Parameters<TQueryFn>[0];\n\nexport type MutationArgs<TMutationFn extends (...args: any[]) => any> =\n    Parameters<TMutationFn>[0];\n\nexport type ActionArgs<TActionFn extends (...args: any[]) => any> =\n    Parameters<TActionFn>[0];"],"mappings":"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"}

package/dist/src/client/index.d.ts

@@ -1,2 +1,2 @@
-import { $ as ProcedureNames, $r as WriteEntry, $t as TxContext, Ar as OccConflictError, Br as QueryCacheMetadataSchema, Cn as InsertData, Cr as DEFAULT_RETRY, Ct as QueryFn, Dr as MutationResult, Er as LiveResult, Et as createActionBuilder, Fr as Predicate, G as RPCError, Gr as RawPointReadSchema, Gt as DefsToMap, Hr as RangeRead, Ht as SupaliveDb, In as defineComputedField, Ir as PredicateSchema, J as ActionProcedures, Jr as RawReadEntry, Jt as ResultOf, K as WSClientOptions, Kr as RawRangeRead, Kt as ParamsOf, Ln as defineSchema, Lr as QueryCacheEntry, Mr as OrPredicateSchema, Nn as SchemaColumnsOptions, Nr as PointRead, Or as NO_RETRY, Ot as createMutationBuilder, Pn as SchemaDefinition, Pr as PointReadSchema, Q as MutationProcedures, Qr as RetryConfig, Qt as DbWriter, Rr as QueryCacheEntrySchema, Sn as InferSchema, Sr as CompareOperatorSchema, St as QueryCtx, Tr as LeafPredicateSchema, Tt as TypeOf, U as ClientPublicState, Un as Database, Ur as RangeReadSchema, Ut as sleep, Vr as QuerySpec, W as HeartbeatOptions, Wn as DbQueryResult, Wr as RawPointRead, Wt as AnyQueryDef, Xr as ReadEntry, Xt as defineQuery, Y as AppRouter, Yn as RawClient, Yr as RawReadEntrySchema, Yt as _resetGlobalDefs, Zr as ReadEntrySchema, Zt as DbReader, _r as CachedPgMetadata, _t as MutationCtx, a as CallOptions, ai as normalizeToBytes, at as router, br as CommitTs, bt as OutputOf, c as LiveQueryHandle, ct as ActionFn, d as WSClientMethods, dt as ContextOf, ei as WriteEntrySchema, et as PublicProcedures, f as createClient, fn as matchesPredicate, gr as BigIntSchema, gt as MutationConfig, hr as AndPredicateSchema, i as createCaller, ii as normalizeIdToBytes, jn as SchemaCodecs, jr as OrPredicate, kr as OccAbortError, kt as createQueryBuilder, l as LiveQueryState, lt as ActionProcedure, mn as ColumnCodec, mr as AndPredicate, n as CallerFromRouter, ni as WriteOpSchema, nt as RegisteredProcedure, o as ClientFromProcedures, ot as ActionConfig, q as WsClientManager, qn as PooledClient, qr as RawRangeReadSchema, qt as QueryDefinition, r as CallerOptions, ri as bytesFromJson, rt as Router, s as ClientOptions, st as ActionCtx, t as CallerFromProcedures, ti as WriteOp, tt as QueryProcedures, u as LiveQueryStatus, ut as AnyProcedure, vn as ComputedFieldConfig, vr as CachedPgMetadataSchema, vt as MutationFn, wn as Model, wr as LeafPredicate, wt as QueryProcedure, xr as CompareOperator, xt as QueryConfig, yr as CommitLogEntry, yt as MutationProcedure, zr as QueryCacheMetadata } from "../../index-DDDAcnJj.js";
+import { $ as ProcedureNames, $r as WriteEntry, $t as TxContext, Ar as OccConflictError, Br as QueryCacheMetadataSchema, Cn as InsertData, Cr as DEFAULT_RETRY, Ct as QueryFn, Dr as MutationResult, Er as LiveResult, Et as createActionBuilder, Fr as Predicate, G as RPCError, Gr as RawPointReadSchema, Gt as DefsToMap, Hr as RangeRead, Ht as SupaliveDb, In as defineComputedField, Ir as PredicateSchema, J as ActionProcedures, Jr as RawReadEntry, Jt as ResultOf, K as WSClientOptions, Kr as RawRangeRead, Kt as ParamsOf, Ln as defineSchema, Lr as QueryCacheEntry, Mr as OrPredicateSchema, Nn as SchemaColumnsOptions, Nr as PointRead, Or as NO_RETRY, Ot as createMutationBuilder, Pn as SchemaDefinition, Pr as PointReadSchema, Q as MutationProcedures, Qr as RetryConfig, Qt as DbWriter, Rr as QueryCacheEntrySchema, Sn as InferSchema, Sr as CompareOperatorSchema, St as QueryCtx, Tr as LeafPredicateSchema, Tt as TypeOf, U as ClientPublicState, Un as Database, Ur as RangeReadSchema, Ut as sleep, Vr as QuerySpec, W as HeartbeatOptions, Wn as DbQueryResult, Wr as RawPointRead, Wt as AnyQueryDef, Xr as ReadEntry, Xt as defineQuery, Y as AppRouter, Yn as RawClient, Yr as RawReadEntrySchema, Yt as _resetGlobalDefs, Zr as ReadEntrySchema, Zt as DbReader, _r as CachedPgMetadata, _t as MutationCtx, a as CallOptions, ai as normalizeToBytes, at as router, br as CommitTs, bt as OutputOf, c as LiveQueryHandle, ct as ActionFn, d as WSClientMethods, dt as ContextOf, ei as WriteEntrySchema, et as PublicProcedures, f as createClient, fn as matchesPredicate, gr as BigIntSchema, gt as MutationConfig, hr as AndPredicateSchema, i as createCaller, ii as normalizeIdToBytes, jn as SchemaCodecs, jr as OrPredicate, kr as OccAbortError, kt as createQueryBuilder, l as LiveQueryState, lt as ActionProcedure, mn as ColumnCodec, mr as AndPredicate, n as CallerFromRouter, ni as WriteOpSchema, nt as RegisteredProcedure, o as ClientFromProcedures, ot as ActionConfig, q as WsClientManager, qn as PooledClient, qr as RawRangeReadSchema, qt as QueryDefinition, r as CallerOptions, ri as bytesFromJson, rt as Router, s as ClientOptions, st as ActionCtx, t as CallerFromProcedures, ti as WriteOp, tt as QueryProcedures, u as LiveQueryStatus, ut as AnyProcedure, vn as ComputedFieldConfig, vr as CachedPgMetadataSchema, vt as MutationFn, wn as Model, wr as LeafPredicate, wt as QueryProcedure, xr as CompareOperator, xt as QueryConfig, yr as CommitLogEntry, yt as MutationProcedure, zr as QueryCacheMetadata } from "../../index-BedlCLem.js";
 export { type ActionConfig, type ActionCtx, type ActionFn, type ActionProcedure, type ActionProcedures, AndPredicate, AndPredicateSchema, type AnyProcedure, type AnyQueryDef, type AppRouter, BigIntSchema, CachedPgMetadata, CachedPgMetadataSchema, type CallOptions, CallerFromProcedures, CallerFromRouter, CallerOptions, type ClientFromProcedures, type ClientOptions, type ClientPublicState, type ColumnCodec, CommitLogEntry, CommitTs, CompareOperator, CompareOperatorSchema, type ComputedFieldConfig, type ContextOf, DEFAULT_RETRY, type Database, type DbQueryResult, DbReader, DbReader as ReadContext, DbWriter, DbWriter as WritableContext, type DefsToMap, type HeartbeatOptions, type InferSchema, type InsertData, LeafPredicate, LeafPredicateSchema, type LiveQueryHandle, type LiveQueryState, type LiveQueryStatus, LiveResult, type Model, type MutationConfig, type MutationCtx, type MutationFn, type MutationProcedure, type MutationProcedures, MutationResult, NO_RETRY, OccAbortError, OccConflictError, OrPredicate, OrPredicateSchema, type OutputOf, type ParamsOf, PointRead, PointReadSchema, type PooledClient, Predicate, PredicateSchema, type ProcedureNames, type PublicProcedures, QueryCacheEntry, QueryCacheEntrySchema, QueryCacheMetadata, QueryCacheMetadataSchema, type QueryConfig, type QueryCtx, type QueryDefinition, type QueryFn, type QueryProcedure, type QueryProcedures, QuerySpec, RPCError, RangeRead, RangeReadSchema, type RawClient, RawPointRead, RawPointReadSchema, RawRangeRead, RawRangeReadSchema, RawReadEntry, RawReadEntrySchema, ReadEntry, ReadEntrySchema, type RegisteredProcedure, type ResultOf, RetryConfig, type Router, type SchemaCodecs, type SchemaColumnsOptions, type SchemaDefinition, SupaliveDb, TxContext, type TypeOf, type WSClientMethods, type WSClientOptions, WriteEntry, WriteEntrySchema, WriteOp, WriteOpSchema, WsClientManager, _resetGlobalDefs, bytesFromJson, createActionBuilder, createCaller, createClient, createMutationBuilder, createQueryBuilder, defineComputedField, defineQuery, defineSchema, matchesPredicate, normalizeIdToBytes, normalizeToBytes, router, sleep };

package/dist/src/client/index.js

@@ -1,11 +1,11 @@
-import { i as createQueryBuilder, r as createMutationBuilder, t as createActionBuilder } from "../../procedure-DPgXC2Cm.js";
-import { n as getContextRegistry, r as router } from "../../router-CiWYeWUR.js";
-import { o as matchesPredicate } from "../../query-Bpw8wO6L.js";
-import { n as defineSchema, t as defineComputedField } from "../../schema-CWdfWuIj.js";
-import { r as supaliveStringify } from "../../helper-wGbzz6zo.js";
-import { C as normalizeIdToBytes, S as bytesFromJson, _ as RawRangeReadSchema, a as DEFAULT_RETRY, b as WriteEntrySchema, c as OccAbortError, d as PointReadSchema, f as PredicateSchema, g as RawPointReadSchema, h as RangeReadSchema, i as CompareOperatorSchema, l as OccConflictError, m as QueryCacheMetadataSchema, n as BigIntSchema, o as LeafPredicateSchema, p as QueryCacheEntrySchema, r as CachedPgMetadataSchema, s as NO_RETRY, t as AndPredicateSchema, u as OrPredicateSchema, v as RawReadEntrySchema, w as normalizeToBytes, x as WriteOpSchema, y as ReadEntrySchema } from "../../types_db-CmxFWgU3.js";
-import { l as ServerMessageSchema } from "../../types_client_rpc-CIsjQQGG.js";
-import { a as TxContext, i as DbWriter, n as sleep, r as DbReader, t as SupaliveDb } from "../../realtime_db-e3TztUUT.js";
+import { c as parentConn, i as createActionBuilder, n as getContextRegistry, o as createMutationBuilder, r as router, s as createQueryBuilder, u as primaryOnlyConn } from "../../router-Kgrlci8X.js";
+import { r as supaliveStringify } from "../../helper-zdJT5FUc.js";
+import { o as matchesPredicate } from "../../query-Xw2hi6TB.js";
+import { n as defineSchema, t as defineComputedField } from "../../schema-DLue3K2s.js";
+import { C as normalizeIdToBytes, S as bytesFromJson, _ as RawRangeReadSchema, a as DEFAULT_RETRY, b as WriteEntrySchema, c as OccAbortError, d as PointReadSchema, f as PredicateSchema, g as RawPointReadSchema, h as RangeReadSchema, i as CompareOperatorSchema, l as OccConflictError, m as QueryCacheMetadataSchema, n as BigIntSchema, o as LeafPredicateSchema, p as QueryCacheEntrySchema, r as CachedPgMetadataSchema, s as NO_RETRY, t as AndPredicateSchema, u as OrPredicateSchema, v as RawReadEntrySchema, w as normalizeToBytes, x as WriteOpSchema, y as ReadEntrySchema } from "../../types_db-OUou3o2Z.js";
+import { l as ServerMessageSchema } from "../../types_client_rpc-ByGwoRCL.js";
+import { a as TxContext, i as DbWriter, n as sleep, r as DbReader, t as SupaliveDb } from "../../realtime_db-CVze3gM0.js";
+import { n as resolveReadRouting, t as makeConnRouting } from "../../read-routing-BUcQAwnd.js";
 import { sha1 } from "hash-wasm";
 //#region src/db/query_definition.ts
 const _globalDefs = /* @__PURE__ */ new Map();
@@ -111,6 +111,7 @@ var WsClientManager = class {
 	explicitlyClosed = false;
 	stateListeners = /* @__PURE__ */ new Set();
 	lastPublicState = "disconnected";
+	highWaterTs = 0n;
 	serverInactivityMs;
 	lastServerMessageAt = 0;
 	inactivityTimer = null;
@@ -335,10 +336,22 @@ var WsClientManager = class {
 				type: "call",
 				id,
 				procedure,
-				input
+				input,
+				minTs: this.highWaterTs > 0n ? this.highWaterTs.toString() : void 0
 			});
 		});
 	}
+	/** Advance the read high-water from a server-returned `ts` (monotonic). */
+	advanceHighWater(ts) {
+		if (ts === void 0) return;
+		let parsed;
+		try {
+			parsed = BigInt(ts);
+		} catch {
+			return;
+		}
+		if (parsed > this.highWaterTs) this.highWaterTs = parsed;
+	}
 	/**
 	* Flush queued calls in FIFO order. Called once `isReady()` becomes
 	* true. With the throttle enabled, dispatch the first batch
@@ -644,12 +657,18 @@ var WsClientManager = class {
 		if (!pending) return;
 		this.pendingRequests.delete(message.id);
 		if (message.success) if (pending.subscribeResolve) pending.subscribeResolve(message.subId);
-		else pending.resolve?.(message.data);
+		else {
+			this.advanceHighWater(message.ts);
+			pending.resolve?.(message.data);
+		}
 		else pending.reject(new RPCError(message.error ?? "Unknown error", message.code));
 	}
 	handleSubscriptionUpdate(message) {
 		const sub = this.subscriptions.get(message.subId);
-		if (sub) sub.onUpdate(message.data);
+		if (sub) {
+			this.advanceHighWater(message.ts);
+			sub.onUpdate(message.data);
+		}
 	}
 	/**
 	* Handles a `sub:gone` message: the server no longer tracks this
@@ -1076,6 +1095,35 @@ var LiveQueryHandleImpl = class {
 //#endregion
 //#region src/client/caller_client.ts
 /**
+* Run a standalone (non-transaction-joining) server-side query with replica
+* routing that DEFAULTS to the primary.
+*
+* Unlike a client one-shot query, the internal caller has no client `minTs`
+* high-water to gate replica staleness — a caller that just performed an
+* internal write and then reads back would silently read a lagging replica. So
+* the safe default here is the PRIMARY; a handler can still opt a heavy
+* reporting read onto the replica with `ctx.useReplicaConn()` (and force back
+* with `ctx.usePrimaryConn()` / `{ readOwnWrite: true }`). The connection knobs
+* use the SAME shared routing rule as the one-shot path ({@link resolveReadRouting}
+* / {@link makeConnRouting}) — the only difference is the DEFAULT connection
+* (primary here, replica-if-caught-up there). With no minTs floor, an explicit
+* `useReplicaConn()` resolves to the replica whenever one is configured. With no
+* replica configured every branch resolves to the primary.
+*/
+async function runRoutedCallerQuery(db, serverCtx, fn) {
+	const routing = await resolveReadRouting(db, await db.impl.getLatestSnapshotTimestamp(), 0n);
+	return (await db.queryInternalOn({
+		impl: routing.primaryImpl,
+		beginTs: routing.primaryTs
+	}, async (dbCtx) => {
+		return fn({
+			db: dbCtx,
+			serverCtx,
+			...makeConnRouting(dbCtx, routing)
+		});
+	})).data;
+}
+/**
 * Create a server-side caller that bypasses HTTP/WebSocket.
 * 
 * For in-memory calls, input validation is skipped (data is already a JS object).
@@ -1108,13 +1156,7 @@ function createCaller(options) {
 			query: async (input, serverCtx) => {
 				if (procedure.type !== "query") throw new Error(`Procedure "${procedureName}" is not a query`);
 				const validatedInput = validateInput(input);
-				return db.query(async (dbCtx) => {
-					const ctx = {
-						db: dbCtx,
-						serverCtx
-					};
-					return procedure.fn(ctx, validatedInput);
-				});
+				return runRoutedCallerQuery(db, serverCtx, (ctx) => procedure.fn(ctx, validatedInput));
 			},
 			runQuery: async (input, parentCtx) => {
 				if (procedure.type !== "query") throw new Error(`Procedure "${procedureName}" is not a query`);
@@ -1122,17 +1164,12 @@ function createCaller(options) {
 				if (parentCtx.db instanceof TxContext) {
 					const ctx = {
 						db: parentCtx.db,
-						serverCtx: parentCtx.serverCtx
+						serverCtx: parentCtx.serverCtx,
+						...parentConn
 					};
 					return procedure.fn(ctx, validatedInput);
 				}
-				return parentCtx.db.query(async (dbCtx) => {
-					const ctx = {
-						db: dbCtx,
-						serverCtx: parentCtx.serverCtx
-					};
-					return procedure.fn(ctx, validatedInput);
-				});
+				return runRoutedCallerQuery(parentCtx.db, parentCtx.serverCtx, (ctx) => procedure.fn(ctx, validatedInput));
 			},
 			mutate: async (input, serverCtx) => {
 				if (procedure.type !== "mutation") throw new Error(`Procedure "${procedureName}" is not a mutation`);
@@ -1140,7 +1177,8 @@ function createCaller(options) {
 				return (await db.mutation(async (dbCtx) => {
 					const ctx = {
 						db: dbCtx,
-						serverCtx
+						serverCtx,
+						...primaryOnlyConn
 					};
 					return procedure.fn(ctx, validatedInput);
 				})).result;
@@ -1151,7 +1189,8 @@ function createCaller(options) {
 				return (await (parentCtx.db instanceof TxContext ? db : parentCtx.db).mutation(async (dbCtx) => {
 					const ctx = {
 						db: dbCtx,
-						serverCtx: parentCtx.serverCtx
+						serverCtx: parentCtx.serverCtx,
+						...primaryOnlyConn
 					};
 					if (parentCtx.db instanceof TxContext) ctx.db.appendInternalReadSet(parentCtx.db.internalGetReadSet());
 					return procedure.fn(ctx, validatedInput);
@@ -1182,7 +1221,8 @@ function createCaller(options) {
 				return db.liveQuery(async (dbCtx) => {
 					const ctx = {
 						db: dbCtx,
-						serverCtx
+						serverCtx,
+						...primaryOnlyConn
 					};
 					return procedure.fn(ctx, validatedInput);
 				});