@lossless.org/client 0.1.1 → 1.1.0

package/ts/nosqldb/classes.ordinarypersistence.ts

@@ -20,6 +20,14 @@ export interface IOrdinaryPersistencePolicy {
 const policySymbol = Symbol.for('@push.rocks/smartdata.ordinaryPersistencePolicy');
 const exactSymbol = Symbol.for('@push.rocks/smartdata.exactPersistencePolicy');
 
+/**
+ * Reports whether a model opted into exact persistence. Exact persistence owns
+ * the stored `_id` as a MongoDB ObjectId, so options that hand the primary key
+ * to a declared identity field must refuse those models by name.
+ */
+export const hasExactPersistencePolicy = (modelArg: any): boolean =>
+  Boolean(modelArg?.[exactSymbol]);
+
 export const getOrdinaryPersistencePolicy = (modelArg: any): IOrdinaryPersistencePolicy | undefined => {
   const policy = modelArg?.[policySymbol] as IOrdinaryPersistencePolicy | undefined;
   if (policy && modelArg[exactSymbol]) {

package/ts/nosqldb/index.ts

@@ -3,6 +3,8 @@ import './shim.js';
 
 export { NoSqlConnection } from './classes.connection.js';
 export type { INoSqlConnectionOptions } from './classes.connection.js';
+export { nosqldbLineage } from './lineage.js';
+export type { INosqldbLineage } from './lineage.js';
 
 export * from './classes.db.js';
 export * from './classes.mongoadministration.js';

package/ts/nosqldb/lineage.ts

@@ -0,0 +1,25 @@
+/**
+ * Provenance of the vendored document implementation. Fixes land in this package; the upstream package is no longer a
+ * release channel, so the baseline states exactly which upstream state consumers inherit and where this fork departs.
+ */
+export interface INosqldbLineage {
+  readonly upstreamPackage: string;
+  readonly upstreamVersion: string;
+  /** Upstream release commit this tree was copied from; it is reachable in this repository's history. */
+  readonly upstreamCommit: string;
+  readonly forkedOn: string;
+  readonly deviations: readonly string[];
+}
+
+export const nosqldbLineage: INosqldbLineage = Object.freeze({
+  upstreamPackage: '@push.rocks/smartdata',
+  upstreamVersion: '11.14.2',
+  upstreamCommit: '9868817a63de72caef787bd8e68bac3deb9d6131',
+  forkedOn: '2026-09-10',
+  deviations: Object.freeze([
+    'classes.connection.ts adds NoSqlConnection with the client backend, capability and readiness contract.',
+    'index.ts exports NoSqlConnection, INoSqlConnectionOptions and this lineage constant.',
+    'classes.collection.ts refuses watch() when the connected backend reports change streams as unsupported.',
+    'The package version file is dropped; versioning belongs to @lossless.org/client.',
+  ]),
+});

package/ts/objectstorage/classes.bucket.ts

@@ -193,19 +193,17 @@ export class Bucket {
   ): Promise<File> {
     try {
       const reducedPath = await helpers.reducePathDescriptorToPath(optionsArg);
-      const exists = await this.fastExists({ path: reducedPath });
-
-      if (exists && !optionsArg.overwrite) {
-        throw new Error(
-          `Object already exists at path '${reducedPath}' in bucket '${this.name}'. ` +
-          `Set overwrite:true to replace it.`
-        );
-      } else if (exists && optionsArg.overwrite) {
-        console.log(
-          `Overwriting existing object at path '${reducedPath}' in bucket '${this.name}'.`
-        );
-      } else {
-        console.log(`Creating new object at path '${reducedPath}' in bucket '${this.name}'.`);
+      if (optionsArg.overwrite !== true) {
+        const exists = await this.fastExists({ path: reducedPath });
+
+        if (exists) {
+          throw new Error(
+            `Object already exists at path '${reducedPath}' in bucket '${this.name}'. ` +
+            `Set overwrite:true to replace it.`
+          );
+        } else {
+          console.log(`Creating new object at path '${reducedPath}' in bucket '${this.name}'.`);
+        }
       }
 
       const command = new plugins.s3.PutObjectCommand({
@@ -525,42 +523,40 @@ export class Bucket {
     };
     let putDispatched = false;
     try {
-      let exists: boolean;
-      try {
-        await operation.runProvider(() => operation.client.send(
-          new plugins.s3.HeadObjectCommand({
-            Bucket: operation.bucketName,
-            Key: optionsArg.path,
-          }),
-          { abortSignal: operation.signal },
-        ));
-        exists = true;
-      } catch (error: any) {
+      if (optionsArg.overwrite !== true) {
+        let exists: boolean;
         try {
-          operation.assertCurrent();
-        } catch (abortError) {
-          throw abortError;
+          await operation.runProvider(() => operation.client.send(
+            new plugins.s3.HeadObjectCommand({
+              Bucket: operation.bucketName,
+              Key: optionsArg.path,
+            }),
+            { abortSignal: operation.signal },
+          ));
+          exists = true;
+        } catch (error: any) {
+          try {
+            operation.assertCurrent();
+          } catch (abortError) {
+            throw abortError;
+          }
+          if (error?.name === 'NotFound') {
+            exists = false;
+          } else {
+            throw error;
+          }
         }
-        if (error?.name === 'NotFound') {
-          exists = false;
+
+        if (exists) {
+          throw new Error(
+            `Object already exists at path '${optionsArg.path}' in bucket '${this.name}'. ` +
+            `Set overwrite:true to replace it.`
+          );
         } else {
-          throw error;
+          console.log(`Creating new object at path '${optionsArg.path}' in bucket '${this.name}'.`);
         }
       }
 
-      if (exists && !optionsArg.overwrite) {
-        throw new Error(
-          `Object already exists at path '${optionsArg.path}' in bucket '${this.name}'. ` +
-          `Set overwrite:true to replace it.`
-        );
-      } else if (exists && optionsArg.overwrite) {
-        console.log(
-          `Overwriting existing object at path '${optionsArg.path}' in bucket '${this.name}'.`
-        );
-      } else {
-        console.log(`Creating new object at path '${optionsArg.path}' in bucket '${this.name}'.`);
-      }
-
       sourceOwnershipStarted = true;
       uploadStream = optionsArg.readableStream instanceof plugins.stream.Readable
         ? optionsArg.readableStream

package/ts/plugins.ts

@@ -1,4 +1,7 @@
+import { requireDriver } from './core/drivers.js';
+
+// Family modules load lazily, so an unconfigured family never resolves its driver package.
 export const loadNoSql = () => import('./nosqldb/classes.connection.js');
-export const loadObjects = () => import('./objectstorage/classes.connection.js');
-export const loadSql = () => import('./sqldb/classes.sqlconnection.js');
-export const loadClickHouse = () => import('./sqldb/classes.clickhouseconnection.js');
+export const loadObjects = () => import('./objectstorage/classes.connection.js').catch(requireDriver('s3'));
+export const loadSql = () => import('./sqldb/classes.sqlconnection.js').catch(requireDriver('mariadb'));
+export const loadClickHouse = () => import('./sqldb/classes.clickhouseconnection.js').catch(requireDriver('clickhouse'));