@clivly/sdk 0.10.7 → 0.10.8

package/dist/chat-session.d.cts

@@ -1,4 +1,4 @@
-import { c as CreateChatSessionHandlerOptions } from "./types-B7HKG2Ph.cjs";
+import { c as CreateChatSessionHandlerOptions } from "./types-CvhxV-IX.cjs";
 //#region src/chat-session.d.ts
 declare function createChatSessionHandler({ allowedOrigins, apiKey, apiUrl, fetchImpl, resolveUser }: CreateChatSessionHandlerOptions): (request: Request) => Promise<Response>;
 //#endregion

package/dist/chat-session.d.mts

@@ -1,4 +1,4 @@
-import { c as CreateChatSessionHandlerOptions } from "./types-B7HKG2Ph.mjs";
+import { c as CreateChatSessionHandlerOptions } from "./types-CvhxV-IX.mjs";
 //#region src/chat-session.d.ts
 declare function createChatSessionHandler({ allowedOrigins, apiKey, apiUrl, fetchImpl, resolveUser }: CreateChatSessionHandlerOptions): (request: Request) => Promise<Response>;
 //#endregion

package/dist/drizzle.cjs

@@ -59,6 +59,7 @@ function fromDrizzleProjection(db, projection, opts) {
 	const head = [`select ${selectItems.join(", ")}`, fromClause].join(" ");
 	return {
 		entity: opts.entity,
+		pushSource: projection.baseTable,
 		cursorField: cursorToken,
 		idField: "id",
 		...opts.objectType === void 0 ? {} : { objectType: opts.objectType },
@@ -88,6 +89,7 @@ function fromDrizzleProjectionByIdentity(client, projection, identityExpr, fromC
 	const head = [`select ${selectItems.join(", ")}`, fromClause].join(" ");
 	return {
 		entity: opts.entity,
+		pushSource: projection.baseTable,
 		cursorField: "id",
 		idField: "id",
 		...opts.objectType === void 0 ? {} : { objectType: opts.objectType },

package/dist/drizzle.d.cts

@@ -1,4 +1,4 @@
-import { _ as SyncSource, y as NamespaceIntrospector } from "./types-B7HKG2Ph.cjs";
+import { _ as SyncSource, y as NamespaceIntrospector } from "./types-CvhxV-IX.cjs";
 import { ProjectionMapping, ProjectionRef } from "@clivly/core";
 import { Table } from "drizzle-orm";
 import { buildUniqueConstraints, discoverFromDrizzle } from "@clivly/core/drizzle";

package/dist/drizzle.d.mts

@@ -1,4 +1,4 @@
-import { _ as SyncSource, y as NamespaceIntrospector } from "./types-B7HKG2Ph.mjs";
+import { _ as SyncSource, y as NamespaceIntrospector } from "./types-CvhxV-IX.mjs";
 import { ProjectionMapping, ProjectionRef } from "@clivly/core";
 import { buildUniqueConstraints, discoverFromDrizzle } from "@clivly/core/drizzle";
 import { Table } from "drizzle-orm";

package/dist/drizzle.mjs

@@ -58,6 +58,7 @@ function fromDrizzleProjection(db, projection, opts) {
 	const head = [`select ${selectItems.join(", ")}`, fromClause].join(" ");
 	return {
 		entity: opts.entity,
+		pushSource: projection.baseTable,
 		cursorField: cursorToken,
 		idField: "id",
 		...opts.objectType === void 0 ? {} : { objectType: opts.objectType },
@@ -87,6 +88,7 @@ function fromDrizzleProjectionByIdentity(client, projection, identityExpr, fromC
 	const head = [`select ${selectItems.join(", ")}`, fromClause].join(" ");
 	return {
 		entity: opts.entity,
+		pushSource: projection.baseTable,
 		cursorField: "id",
 		idField: "id",
 		...opts.objectType === void 0 ? {} : { objectType: opts.objectType },

package/dist/index.cjs

@@ -79,6 +79,43 @@ function resolveEntitySource(config, entityKey) {
 function expectedSourceKey(concept) {
 	return CONCEPT_KEYS[concept] ?? "custom";
 }
+/**
+* The `source` label a push must carry for the server to find its mapping.
+*
+* `entity` is the SDK's own name for a source — the cursor-store key, and what
+* the developer wrote in `config.source`. It is NOT always what the server
+* filed the mapping under: for a projection, `ensureSchema` stores
+* `sourceTable` as `projection.baseTable`, because a projection entity's key
+* doubles as a kebab-case object slug and cannot also be the snake_case
+* `projection.entityKey`.
+*
+* Pushing under `entity` therefore dropped 100% of a projection's rows while
+* every local signal said the setup was correct. One function so the three
+* push sites cannot drift apart again.
+*/
+function pushSourceOf(source) {
+	return source.pushSource ?? source.entity;
+}
+/**
+* The push label for a custom source, resolved against the config.
+*
+* `fromDrizzleProjection` stamps `pushSource` itself, but a projection source
+* can equally be hand-built — `fromDrizzle` with an overridden `fetchPage` is
+* what the README's own example leads you to, and next-finance did exactly
+* that. Such a source has no `pushSource`, so the label has to come from the
+* one place that is true either way: the entity's declared
+* `projection.baseTable`.
+*
+* Matched on the source's `entity`, which for a custom source is also the
+* config entity key (that is what `resolveEntitySource` above pairs them by).
+* Falls back to `pushSourceOf`, so a non-projection custom source and an
+* already-stamped one both keep their current label.
+*/
+function customPushSource(config, source) {
+	if (source.pushSource) return source.pushSource;
+	const entities = config.entities?.entities;
+	return (entities?.[source.entity] ?? Object.values(entities ?? {}).find((e) => e.source === source.entity))?.projection?.baseTable ?? source.entity;
+}
 //#endregion
 //#region src/concept-coverage.ts
 const CHECK_NAME$1 = "Entity → source coverage";
@@ -1205,7 +1242,7 @@ async function pushRemoteProjections(args) {
 		}
 		try {
 			const ok = await args.push(SYNC_CUSTOM_PATH$1, {
-				source: source.entity,
+				source: pushSourceOf(source),
 				rows: all,
 				mode: "full",
 				fetched: all.length,
@@ -1280,7 +1317,7 @@ async function syncSource(args) {
 		if (rows.length === 0) break;
 		const capped = maxRows === void 0 ? rows : rows.slice(0, maxRows);
 		if (!await push(path, {
-			source: source.entity,
+			source: pushSourceOf(source),
 			rows: capped,
 			mode: "delta",
 			fetched: rows.length,
@@ -1324,7 +1361,7 @@ async function fullSyncSource(args) {
 		ok: true
 	};
 	const ok = await push(path, {
-		source: source.entity,
+		source: pushSourceOf(source),
 		rows: all,
 		mode: "full",
 		fetched: all.length,
@@ -1835,7 +1872,10 @@ function createClivlySDK(config) {
 	};
 	const syncCustomSources = async (customSources, mode, runId) => {
 		const failed = [];
-		for (const customSource of customSources ?? []) if (!await syncOne(customSource, SYNC_CUSTOM_PATH, mode, customSource.objectType, runId)) failed.push(customSource.entity);
+		for (const customSource of customSources ?? []) {
+			customSource.pushSource = customPushSource(config, customSource);
+			if (!await syncOne(customSource, SYNC_CUSTOM_PATH, mode, customSource.objectType, runId)) failed.push(customSource.entity);
+		}
 		return failed;
 	};
 	const syncRemoteSources = async (sources, runId) => {

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { a as ClivlySDK, c as CreateChatSessionHandlerOptions, d as DoctorCheck, f as DoctorReport, g as RemoteProjectionsDescription, h as EnsuredObjectTypeResult, i as ClivlyConnectResult, l as CursorStore, m as EnsuredMappingResult, n as ChatWidgetVisitor, o as ClivlySDKConfig, p as EnsureSchemaResult, r as ClivlyConnectReason, s as ClivlyUser, t as ChatSessionRequestBody, u as DiscoveredTable, v as SyncTriggerDescription } from "./types-B7HKG2Ph.cjs";
+import { a as ClivlySDK, c as CreateChatSessionHandlerOptions, d as DoctorCheck, f as DoctorReport, g as RemoteProjectionsDescription, h as EnsuredObjectTypeResult, i as ClivlyConnectResult, l as CursorStore, m as EnsuredMappingResult, n as ChatWidgetVisitor, o as ClivlySDKConfig, p as EnsureSchemaResult, r as ClivlyConnectReason, s as ClivlyUser, t as ChatSessionRequestBody, u as DiscoveredTable, v as SyncTriggerDescription } from "./types-CvhxV-IX.cjs";
 import { createChatSessionHandler } from "./chat-session.cjs";
 import { ClivlyEntitiesConfig, ConfigValidationError, ConfigValidationResult, CustomObjectDeclaration, DiscoveredSchemaTable, customObjectDeclarations, defineClivlyConfig, validateEntitiesConfig } from "@clivly/core/entity-config";
 //#region src/trigger-url.d.ts

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { a as ClivlySDK, c as CreateChatSessionHandlerOptions, d as DoctorCheck, f as DoctorReport, g as RemoteProjectionsDescription, h as EnsuredObjectTypeResult, i as ClivlyConnectResult, l as CursorStore, m as EnsuredMappingResult, n as ChatWidgetVisitor, o as ClivlySDKConfig, p as EnsureSchemaResult, r as ClivlyConnectReason, s as ClivlyUser, t as ChatSessionRequestBody, u as DiscoveredTable, v as SyncTriggerDescription } from "./types-B7HKG2Ph.mjs";
+import { a as ClivlySDK, c as CreateChatSessionHandlerOptions, d as DoctorCheck, f as DoctorReport, g as RemoteProjectionsDescription, h as EnsuredObjectTypeResult, i as ClivlyConnectResult, l as CursorStore, m as EnsuredMappingResult, n as ChatWidgetVisitor, o as ClivlySDKConfig, p as EnsureSchemaResult, r as ClivlyConnectReason, s as ClivlyUser, t as ChatSessionRequestBody, u as DiscoveredTable, v as SyncTriggerDescription } from "./types-CvhxV-IX.mjs";
 import { createChatSessionHandler } from "./chat-session.mjs";
 import { ClivlyEntitiesConfig, ConfigValidationError, ConfigValidationResult, CustomObjectDeclaration, DiscoveredSchemaTable, customObjectDeclarations, defineClivlyConfig, validateEntitiesConfig } from "@clivly/core/entity-config";
 //#region src/trigger-url.d.ts

package/dist/index.mjs

@@ -78,6 +78,43 @@ function resolveEntitySource(config, entityKey) {
 function expectedSourceKey(concept) {
 	return CONCEPT_KEYS[concept] ?? "custom";
 }
+/**
+* The `source` label a push must carry for the server to find its mapping.
+*
+* `entity` is the SDK's own name for a source — the cursor-store key, and what
+* the developer wrote in `config.source`. It is NOT always what the server
+* filed the mapping under: for a projection, `ensureSchema` stores
+* `sourceTable` as `projection.baseTable`, because a projection entity's key
+* doubles as a kebab-case object slug and cannot also be the snake_case
+* `projection.entityKey`.
+*
+* Pushing under `entity` therefore dropped 100% of a projection's rows while
+* every local signal said the setup was correct. One function so the three
+* push sites cannot drift apart again.
+*/
+function pushSourceOf(source) {
+	return source.pushSource ?? source.entity;
+}
+/**
+* The push label for a custom source, resolved against the config.
+*
+* `fromDrizzleProjection` stamps `pushSource` itself, but a projection source
+* can equally be hand-built — `fromDrizzle` with an overridden `fetchPage` is
+* what the README's own example leads you to, and next-finance did exactly
+* that. Such a source has no `pushSource`, so the label has to come from the
+* one place that is true either way: the entity's declared
+* `projection.baseTable`.
+*
+* Matched on the source's `entity`, which for a custom source is also the
+* config entity key (that is what `resolveEntitySource` above pairs them by).
+* Falls back to `pushSourceOf`, so a non-projection custom source and an
+* already-stamped one both keep their current label.
+*/
+function customPushSource(config, source) {
+	if (source.pushSource) return source.pushSource;
+	const entities = config.entities?.entities;
+	return (entities?.[source.entity] ?? Object.values(entities ?? {}).find((e) => e.source === source.entity))?.projection?.baseTable ?? source.entity;
+}
 //#endregion
 //#region src/concept-coverage.ts
 const CHECK_NAME$1 = "Entity → source coverage";
@@ -1204,7 +1241,7 @@ async function pushRemoteProjections(args) {
 		}
 		try {
 			const ok = await args.push(SYNC_CUSTOM_PATH$1, {
-				source: source.entity,
+				source: pushSourceOf(source),
 				rows: all,
 				mode: "full",
 				fetched: all.length,
@@ -1279,7 +1316,7 @@ async function syncSource(args) {
 		if (rows.length === 0) break;
 		const capped = maxRows === void 0 ? rows : rows.slice(0, maxRows);
 		if (!await push(path, {
-			source: source.entity,
+			source: pushSourceOf(source),
 			rows: capped,
 			mode: "delta",
 			fetched: rows.length,
@@ -1323,7 +1360,7 @@ async function fullSyncSource(args) {
 		ok: true
 	};
 	const ok = await push(path, {
-		source: source.entity,
+		source: pushSourceOf(source),
 		rows: all,
 		mode: "full",
 		fetched: all.length,
@@ -1834,7 +1871,10 @@ function createClivlySDK(config) {
 	};
 	const syncCustomSources = async (customSources, mode, runId) => {
 		const failed = [];
-		for (const customSource of customSources ?? []) if (!await syncOne(customSource, SYNC_CUSTOM_PATH, mode, customSource.objectType, runId)) failed.push(customSource.entity);
+		for (const customSource of customSources ?? []) {
+			customSource.pushSource = customPushSource(config, customSource);
+			if (!await syncOne(customSource, SYNC_CUSTOM_PATH, mode, customSource.objectType, runId)) failed.push(customSource.entity);
+		}
 		return failed;
 	};
 	const syncRemoteSources = async (sources, runId) => {

package/dist/{types-B7HKG2Ph.d.cts → types-CvhxV-IX.d.cts}

@@ -376,6 +376,22 @@ interface SyncSource {
    * absent from another, and read by the runtime.
    */
   objectType?: string;
+  /**
+   * The `source` label a push carries, when it differs from `entity`.
+   *
+   * Only a projection sets this, and only because a projection entity has no
+   * choice but to carry two names: its entity key doubles as the custom-object
+   * slug and must be kebab-case, while `projection.entityKey` is validated by
+   * `/^[a-z][a-z0-9_]*$/` and rejects hyphens. The server resolves that by
+   * storing the mapping's `sourceTable` as `projection.baseTable` — so a push
+   * labelled with the entity key matched no mapping and every row was dropped,
+   * while `push-schema` reported the mapping created and exited 0.
+   *
+   * Deliberately NOT folded into `entity`: that value is also the cursor-store
+   * key, so redefining it would silently reset the sync cursor of every
+   * existing projection and re-push its whole history.
+   */
+  pushSource?: string;
   /** Set by `fromDrizzle`; lets `doctor` introspect the backing table. */
   [DRIZZLE_META]?: DrizzleSourceMeta;
 }

package/dist/{types-B7HKG2Ph.d.mts → types-CvhxV-IX.d.mts}

@@ -376,6 +376,22 @@ interface SyncSource {
    * absent from another, and read by the runtime.
    */
   objectType?: string;
+  /**
+   * The `source` label a push carries, when it differs from `entity`.
+   *
+   * Only a projection sets this, and only because a projection entity has no
+   * choice but to carry two names: its entity key doubles as the custom-object
+   * slug and must be kebab-case, while `projection.entityKey` is validated by
+   * `/^[a-z][a-z0-9_]*$/` and rejects hyphens. The server resolves that by
+   * storing the mapping's `sourceTable` as `projection.baseTable` — so a push
+   * labelled with the entity key matched no mapping and every row was dropped,
+   * while `push-schema` reported the mapping created and exited 0.
+   *
+   * Deliberately NOT folded into `entity`: that value is also the cursor-store
+   * key, so redefining it would silently reset the sync cursor of every
+   * existing projection and re-push its whole history.
+   */
+  pushSource?: string;
   /** Set by `fromDrizzle`; lets `doctor` introspect the backing table. */
   [DRIZZLE_META]?: DrizzleSourceMeta;
 }

package/dist/vite.d.cts

@@ -1,4 +1,4 @@
-import { a as ClivlySDK } from "./types-B7HKG2Ph.cjs";
+import { a as ClivlySDK } from "./types-CvhxV-IX.cjs";
 import { Plugin } from "vite";
 //#region src/vite.d.ts
 interface ClivlyViteOptions {

package/dist/vite.d.mts

@@ -1,4 +1,4 @@
-import { a as ClivlySDK } from "./types-B7HKG2Ph.mjs";
+import { a as ClivlySDK } from "./types-CvhxV-IX.mjs";
 import { Plugin } from "vite";
 //#region src/vite.d.ts
 interface ClivlyViteOptions {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clivly/sdk",
-  "version": "0.10.7",
+  "version": "0.10.8",
   "private": false,
   "description": "Clivly SDK — connect your app to Clivly Cloud (heartbeat, discovery, auth bridge).",
   "license": "MIT",
@@ -52,7 +52,7 @@
     "dist"
   ],
   "dependencies": {
-    "@clivly/core": "0.10.7"
+    "@clivly/core": "0.10.8"
   },
   "devDependencies": {
     "@electric-sql/pglite": "^0.5.4",