declastruct 1.1.10 → 1.1.11

package/dist/domain.objects/DeclastructDao.d.ts

@@ -2,37 +2,41 @@ import { DomainEntity, DomainLiteral, Ref, Refable, RefByPrimary, RefByUnique }
 import { HasMetadata } from 'type-fns';
 /**
  * .what = standardized data access interface for any resource type
+ *
  * .why = enforces idempotent semantics and consistent access patterns across all providers
- * .note = TResourceClass is the class constructor (e.g., typeof MyResource) with static unique/primary properties
+ *
+ * .note =
+ *   - TResourceClass is the class constructor (e.g., typeof MyResource) with static unique/primary properties
+ *   - uses method syntax in the get & set for bivariance, to enable assignment to DeclastructDao<any, any, any>
  */
 export interface DeclastructDao<TResource extends DomainEntity<any>, TResourceClass extends Refable<any, any, any>, TContext = never> {
     get: {
         /**
          * required - fetch by unique keys (enables idempotency)
          */
-        byUnique: (input: RefByUnique<TResourceClass>, context: TContext) => Promise<TResource | null>;
+        byUnique(input: RefByUnique<TResourceClass>, context: TContext): Promise<TResource | null>;
         /**
          * optional - fetch by primary keys (if resource supports them)
          */
-        byPrimary?: (input: RefByPrimary<TResourceClass>, context: TContext) => Promise<TResource | null>;
+        byPrimary?(input: RefByPrimary<TResourceClass>, context: TContext): Promise<TResource | null>;
         /**
          * required - fetch by any supported reference type
          */
-        byRef: (input: Ref<TResourceClass>, context: TContext) => Promise<TResource | null>;
+        byRef(input: Ref<TResourceClass>, context: TContext): Promise<TResource | null>;
     };
     set: {
         /**
          * required - find or insert resource (idempotent create)
          */
-        finsert: (input: TResource, context: TContext) => Promise<HasMetadata<TResource>>;
+        finsert(input: TResource, context: TContext): Promise<HasMetadata<TResource>>;
         /**
          * optional - create or update resource (idempotent upsert)
          */
-        upsert?: (input: TResource, context: TContext) => Promise<HasMetadata<TResource>>;
+        upsert?(input: TResource, context: TContext): Promise<HasMetadata<TResource>>;
         /**
          * optional - delete resource
          */
-        delete?: (input: Ref<TResourceClass>, context: TContext) => Promise<void>;
+        delete?(input: Ref<TResourceClass>, context: TContext): Promise<void>;
     };
 }
 export declare class DeclastructDao<TResource extends DomainEntity<any>, TResourceClass extends Refable<any, any, any>, TContext> extends DomainLiteral<DeclastructDao<TResource, TResourceClass, TContext>> implements DeclastructDao<TResource, TResourceClass, TContext> {

package/dist/domain.objects/DeclastructDao.js.map

@@ -1 +1 @@
-{"version":3,"file":"DeclastructDao.js","sourceRoot":"","sources":["../../src/domain.objects/DeclastructDao.ts"],"names":[],"mappings":";;;AAAA,mDAOwB;AA+DxB,MAAa,cAKX,SAAQ,8BAAkE;CACT;AANnE,wCAMmE"}
+{"version":3,"file":"DeclastructDao.js","sourceRoot":"","sources":["../../src/domain.objects/DeclastructDao.ts"],"names":[],"mappings":";;;AAAA,mDAOwB;AAmExB,MAAa,cAKX,SAAQ,8BAAkE;CACT;AANnE,wCAMmE"}

package/dist/domain.objects/DeclastructProvider.test.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const domain_objects_1 = require("domain-objects");
 const DeclastructProvider_1 = require("./DeclastructProvider");
 describe('DeclastructProvider', () => {
     it('should build a provider with all required properties', () => {
@@ -31,5 +32,49 @@ describe('DeclastructProvider', () => {
         });
         expect(provider).toBeDefined();
     });
+    describe('resource with optional primary key', () => {
+        class DemoResourceWithOptionalPrimary extends domain_objects_1.DomainEntity {
+        }
+        DemoResourceWithOptionalPrimary.primary = ['uuid'];
+        DemoResourceWithOptionalPrimary.unique = ['name'];
+        it('should work with daos that have optional primary keys and byPrimary defined', () => {
+            // define a dao for the resource with optional primary key
+            const demoDao = {
+                get: {
+                    byUnique: async () => null,
+                    byPrimary: async (input) => {
+                        // input.uuid should be string (not string | undefined)
+                        const uuid = input.uuid;
+                        expect(uuid).toBeDefined();
+                        return null;
+                    },
+                    byRef: async () => null,
+                },
+                set: {
+                    finsert: async (r) => r,
+                },
+            };
+            // build provider with the dao
+            const provider = new DeclastructProvider_1.DeclastructProvider({
+                name: 'optional-primary-key-provider',
+                daos: {
+                    DemoResourceWithOptionalPrimary: demoDao,
+                },
+                context: {},
+                hooks: {
+                    beforeAll: async () => { },
+                    afterAll: async () => { },
+                },
+            });
+            // verify provider structure
+            expect(provider.name).toBe('optional-primary-key-provider');
+            expect(provider.daos.DemoResourceWithOptionalPrimary).toBeDefined();
+            // access dao to verify structure
+            const dao = provider.daos.DemoResourceWithOptionalPrimary;
+            expect(dao?.get.byPrimary).toBeDefined();
+            expect(dao?.get.byUnique).toBeDefined();
+            expect(dao?.set.finsert).toBeDefined();
+        });
+    });
 });
 //# sourceMappingURL=DeclastructProvider.test.js.map

package/dist/domain.objects/DeclastructProvider.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"DeclastructProvider.test.js","sourceRoot":"","sources":["../../src/domain.objects/DeclastructProvider.test.ts"],"names":[],"mappings":";;AAAA,+DAA4D;AAE5D,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,QAAQ,GAAG,IAAI,yCAAmB,CAAC;YACvC,IAAI,EAAE,eAAe;YACrB,IAAI,EAAE,EAAE;YACR,OAAO,EAAE,EAAE;YACX,KAAK,EAAE;gBACL,SAAS,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;gBACzB,QAAQ,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;aACzB;SACF,CAAC,CAAC;QAEH,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC5C,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAClC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACrC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;QAC/C,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,0DAA0D;QAC1D,MAAM,QAAQ,GAAG,IAAI,yCAAmB,CAAC;YACvC,IAAI,EAAE,kBAAkB;YACxB,IAAI,EAAE,EAAE;YACR,OAAO,EAAE,EAAE;YACX,KAAK,EAAE;gBACL,SAAS,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;gBACzB,QAAQ,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;aACzB;SACF,CAAC,CAAC;QAEH,MAAM,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IACjC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"DeclastructProvider.test.js","sourceRoot":"","sources":["../../src/domain.objects/DeclastructProvider.test.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -2,7 +2,7 @@
   "name": "declastruct",
   "author": "ehmpathy",
   "description": "Add declarative control to any resource constructs. Declare, plan, and apply within an observable pit-of-success.",
-  "version": "1.1.10",
+  "version": "1.1.11",
   "repository": "ehmpathy/declastruct",
   "homepage": "https://github.com/ehmpathy/declastruct",
   "keywords": [