@effect-dynamodb/language-service 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Justin Menga
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,30 @@
+# @effect-dynamodb/language-service
+
+TypeScript Language Service Plugin for [`effect-dynamodb`](https://www.npmjs.com/package/effect-dynamodb). Shows DynamoDB operation details — partition key, sort key, index name, conditions — directly in editor hover tooltips.
+
+[![npm](https://img.shields.io/npm/v/@effect-dynamodb/language-service)](https://www.npmjs.com/package/@effect-dynamodb/language-service)
+[![license](https://img.shields.io/npm/l/@effect-dynamodb/language-service)](./LICENSE)
+
+**Documentation:** https://jmenga.github.io/effect-dynamodb
+
+## Installation
+
+```bash
+pnpm add -D @effect-dynamodb/language-service
+```
+
+Then enable in `tsconfig.json`:
+
+```json
+{
+  "compilerOptions": {
+    "plugins": [{ "name": "@effect-dynamodb/language-service" }]
+  }
+}
+```
+
+VS Code: ensure "TypeScript › Tsserver: Use Workspace TSDK" is enabled, or run **TypeScript: Select TypeScript Version → Use Workspace Version**.
+
+## License
+
+[MIT](./LICENSE)

package/dist/core/Cache.d.ts

@@ -0,0 +1,7 @@
+import type { ResolvedCollection, ResolvedEntity } from "./EntityResolver.js";
+export declare const getEntities: (fileName: string, version: number) => ReadonlyArray<ResolvedEntity> | undefined;
+export declare const getCollections: (fileName: string, version: number) => ReadonlyArray<ResolvedCollection> | undefined;
+export declare const setEntities: (fileName: string, version: number, entities: ReadonlyArray<ResolvedEntity>, collections?: ReadonlyArray<ResolvedCollection>) => void;
+export declare const invalidate: (fileName: string) => void;
+export declare const clear: () => void;
+//# sourceMappingURL=Cache.d.ts.map

package/dist/core/Cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Cache.d.ts","sourceRoot":"","sources":["../../src/core/Cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAU7E,eAAO,MAAM,WAAW,GACtB,UAAU,MAAM,EAChB,SAAS,MAAM,KACd,aAAa,CAAC,cAAc,CAAC,GAAG,SAMlC,CAAA;AAED,eAAO,MAAM,cAAc,GACzB,UAAU,MAAM,EAChB,SAAS,MAAM,KACd,aAAa,CAAC,kBAAkB,CAAC,GAAG,SAMtC,CAAA;AAED,eAAO,MAAM,WAAW,GACtB,UAAU,MAAM,EAChB,SAAS,MAAM,EACf,UAAU,aAAa,CAAC,cAAc,CAAC,EACvC,cAAa,aAAa,CAAC,kBAAkB,CAAM,KAClD,IAEF,CAAA;AAED,eAAO,MAAM,UAAU,GAAI,UAAU,MAAM,KAAG,IAE7C,CAAA;AAED,eAAO,MAAM,KAAK,QAAO,IAExB,CAAA"}

package/dist/core/Cache.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clear = exports.invalidate = exports.setEntities = exports.getCollections = exports.getEntities = void 0;
+const cache = new Map();
+const getEntities = (fileName, version) => {
+    const entry = cache.get(fileName);
+    if (entry && entry.version === version) {
+        return entry.entities;
+    }
+    return undefined;
+};
+exports.getEntities = getEntities;
+const getCollections = (fileName, version) => {
+    const entry = cache.get(fileName);
+    if (entry && entry.version === version) {
+        return entry.collections;
+    }
+    return undefined;
+};
+exports.getCollections = getCollections;
+const setEntities = (fileName, version, entities, collections = []) => {
+    cache.set(fileName, { version, entities, collections });
+};
+exports.setEntities = setEntities;
+const invalidate = (fileName) => {
+    cache.delete(fileName);
+};
+exports.invalidate = invalidate;
+const clear = () => {
+    cache.clear();
+};
+exports.clear = clear;
+//# sourceMappingURL=Cache.js.map

package/dist/core/Cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Cache.js","sourceRoot":"","sources":["../../src/core/Cache.ts"],"names":[],"mappings":";;;AAQA,MAAM,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAA;AAEpC,MAAM,WAAW,GAAG,CACzB,QAAgB,EAChB,OAAe,EAC4B,EAAE;IAC7C,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IACjC,IAAI,KAAK,IAAI,KAAK,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;QACvC,OAAO,KAAK,CAAC,QAAQ,CAAA;IACvB,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC,CAAA;AATY,QAAA,WAAW,eASvB;AAEM,MAAM,cAAc,GAAG,CAC5B,QAAgB,EAChB,OAAe,EACgC,EAAE;IACjD,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IACjC,IAAI,KAAK,IAAI,KAAK,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;QACvC,OAAO,KAAK,CAAC,WAAW,CAAA;IAC1B,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC,CAAA;AATY,QAAA,cAAc,kBAS1B;AAEM,MAAM,WAAW,GAAG,CACzB,QAAgB,EAChB,OAAe,EACf,QAAuC,EACvC,cAAiD,EAAE,EAC7C,EAAE;IACR,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAA;AACzD,CAAC,CAAA;AAPY,QAAA,WAAW,eAOvB;AAEM,MAAM,UAAU,GAAG,CAAC,QAAgB,EAAQ,EAAE;IACnD,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;AACxB,CAAC,CAAA;AAFY,QAAA,UAAU,cAEtB;AAEM,MAAM,KAAK,GAAG,GAAS,EAAE;IAC9B,KAAK,CAAC,KAAK,EAAE,CAAA;AACf,CAAC,CAAA;AAFY,QAAA,KAAK,SAEjB"}

package/dist/core/EntityResolver.d.ts

@@ -0,0 +1,58 @@
+import type ts from "typescript";
+export type Casing = "lowercase" | "uppercase" | "preserve";
+export interface KeyPart {
+    readonly field: string;
+    readonly composite: ReadonlyArray<string>;
+}
+export interface IndexDefinition {
+    readonly index?: string | undefined;
+    readonly collection?: string | ReadonlyArray<string> | undefined;
+    readonly type?: "isolated" | "clustered" | undefined;
+    readonly pk: KeyPart;
+    readonly sk: KeyPart;
+    readonly casing?: Casing | undefined;
+}
+export interface SchemaConfig {
+    readonly name: string;
+    readonly version: number;
+    readonly casing: Casing;
+}
+export interface ResolvedEntity {
+    readonly variableName: string;
+    readonly entityType: string;
+    readonly schema: SchemaConfig;
+    readonly indexes: Record<string, IndexDefinition>;
+    readonly timestamps: boolean | object;
+    readonly versioned: boolean | object;
+    readonly softDelete: boolean | object;
+    readonly unique: object | undefined;
+}
+export interface ResolvedCollectionMember {
+    readonly entityVariableName: string;
+    readonly sk: {
+        readonly composite: ReadonlyArray<string>;
+    };
+}
+export interface ResolvedCollection {
+    readonly variableName: string;
+    readonly collectionName: string;
+    readonly index: string;
+    readonly type: "clustered" | "isolated";
+    readonly pk: KeyPart;
+    readonly sk: {
+        readonly field: string;
+    };
+    readonly members: Record<string, ResolvedCollectionMember>;
+}
+export declare function resolveEntities(ts: typeof import("typescript"), sourceFile: ts.SourceFile, program?: ts.Program): ReadonlyArray<ResolvedEntity>;
+declare function extractStringLiteral(ts: typeof import("typescript"), expr: ts.Expression): string | undefined;
+declare function extractNumberLiteral(ts: typeof import("typescript"), expr: ts.Expression): number | undefined;
+declare function extractObjectLiteral(ts: typeof import("typescript"), expr: ts.Expression): Record<string, unknown> | undefined;
+declare function extractLiteralValue(ts: typeof import("typescript"), expr: ts.Expression): unknown;
+declare function extractStringArray(ts: typeof import("typescript"), expr: ts.Expression): ReadonlyArray<string> | undefined;
+/**
+ * Resolve all Collections.make() calls in a source file.
+ */
+export declare function resolveCollections(ts: typeof import("typescript"), sourceFile: ts.SourceFile): ReadonlyArray<ResolvedCollection>;
+export { extractStringLiteral, extractNumberLiteral, extractLiteralValue, extractStringArray, extractObjectLiteral, };
+//# sourceMappingURL=EntityResolver.d.ts.map

package/dist/core/EntityResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityResolver.d.ts","sourceRoot":"","sources":["../../src/core/EntityResolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAA;AAEhC,MAAM,MAAM,MAAM,GAAG,WAAW,GAAG,WAAW,GAAG,UAAU,CAAA;AAE3D,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;CAC1C;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,SAAS,CAAA;IAChE,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,WAAW,GAAG,SAAS,CAAA;IACpD,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAA;IACpB,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAA;IACpB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACrC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;IACjD,QAAQ,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,CAAA;IACrC,QAAQ,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,CAAA;IACpC,QAAQ,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,CAAA;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;CACpC;AAMD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;IACnC,QAAQ,CAAC,EAAE,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;KAAE,CAAA;CAC3D;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,UAAU,CAAA;IACvC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAA;IACpB,QAAQ,CAAC,EAAE,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAA;CAC3D;AAED,wBAAgB,eAAe,CAC7B,EAAE,EAAE,cAAc,YAAY,CAAC,EAC/B,UAAU,EAAE,EAAE,CAAC,UAAU,EACzB,OAAO,CAAC,EAAE,EAAE,CAAC,OAAO,GACnB,aAAa,CAAC,cAAc,CAAC,CA0C/B;AAkbD,iBAAS,oBAAoB,CAC3B,EAAE,EAAE,cAAc,YAAY,CAAC,EAC/B,IAAI,EAAE,EAAE,CAAC,UAAU,GAClB,MAAM,GAAG,SAAS,CAKpB;AAED,iBAAS,oBAAoB,CAC3B,EAAE,EAAE,cAAc,YAAY,CAAC,EAC/B,IAAI,EAAE,EAAE,CAAC,UAAU,GAClB,MAAM,GAAG,SAAS,CAapB;AAcD,iBAAS,oBAAoB,CAC3B,EAAE,EAAE,cAAc,YAAY,CAAC,EAC/B,IAAI,EAAE,EAAE,CAAC,UAAU,GAClB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAQrC;AAED,iBAAS,mBAAmB,CAAC,EAAE,EAAE,cAAc,YAAY,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,UAAU,GAAG,OAAO,CAS1F;AAED,iBAAS,kBAAkB,CACzB,EAAE,EAAE,cAAc,YAAY,CAAC,EAC/B,IAAI,EAAE,EAAE,CAAC,UAAU,GAClB,aAAa,CAAC,MAAM,CAAC,GAAG,SAAS,CASnC;AAeD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,cAAc,YAAY,CAAC,EAC/B,UAAU,EAAE,EAAE,CAAC,UAAU,GACxB,aAAa,CAAC,kBAAkB,CAAC,CAgBnC;AA6HD,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,GACrB,CAAA"}