@sovecom/module-sdk 1.0.0-rc.1

package/dist/tables.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createNamespacedTable = createNamespacedTable;
+/**
+ * `createNamespacedTable`: a DDL/migration AUTHORING helper that enforces the `mod_<name>_`
+ * table-name prefix.
+ *
+ * It returns a namespaced table NAME (a DDL identifier the author uses in their migration source
+ * and `db/schema.ts`). It does NOT return a live Drizzle/pg handle or query builder — module
+ * own-table access AT RUNTIME is parameterized SQL via `sdk.tables.query/exec` (the broker's
+ * gated module-sql executor), the only data path that exists.
+ *
+ * The prefix rule mirrors `moduleManifestSchema`'s table superRefine: the module name is a
+ * lowercase slug, the table suffix is `[a-z0-9_]+`, and the full identifier is
+ * `mod_<name>_<suffix>`. This is the SAME shape the manifest's `tables` array must satisfy, so an
+ * author can feed these names straight into their manifest and pass verification.
+ */
+const manifest_js_1 = require("./manifest.js");
+/**
+ * Build the namespaced DDL identifier `mod_<module>_<suffix>` for an author's own table.
+ *
+ * @param moduleName the module's manifest `name` (lowercase slug, `^[a-z][a-z0-9-]*$`).
+ * @param suffix the table's local name within the module (lowercase, `[a-z0-9_]+`).
+ * @returns the fully-namespaced table name, e.g. `createNamespacedTable('wishlist', 'items')`
+ *          → `'mod_wishlist_items'`.
+ * @throws if `moduleName` is not a valid module slug or `suffix` is empty/invalid.
+ */
+function createNamespacedTable(moduleName, suffix) {
+    if (typeof moduleName !== 'string' || !manifest_js_1.MODULE_NAME_RE.test(moduleName)) {
+        throw new Error(`createNamespacedTable: module name "${String(moduleName)}" must be a lowercase slug`);
+    }
+    if (typeof suffix !== 'string' || !manifest_js_1.TABLE_SUFFIX_RE.test(suffix)) {
+        throw new Error(`createNamespacedTable: table suffix "${String(suffix)}" must be lowercase [a-z0-9_]`);
+    }
+    // Defence in depth: reject a suffix that would re-introduce the prefix or escape the namespace.
+    if (suffix.startsWith('mod_')) {
+        throw new Error(`createNamespacedTable: table suffix "${suffix}" must not start with the reserved "mod_" prefix`);
+    }
+    return `mod_${moduleName}_${suffix}`;
+}
+//# sourceMappingURL=tables.js.map

package/dist/tables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tables.js","sourceRoot":"","sources":["../src/tables.ts"],"names":[],"mappings":";;AAyBA,sDAkBC;AA3CD;;;;;;;;;;;;;GAaG;AACH,+CAAgE;AAEhE;;;;;;;;GAQG;AACH,SAAgB,qBAAqB,CAAC,UAAkB,EAAE,MAAc;IACtE,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,CAAC,4BAAc,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACvE,MAAM,IAAI,KAAK,CACb,uCAAuC,MAAM,CAAC,UAAU,CAAC,4BAA4B,CACtF,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,6BAAe,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,KAAK,CACb,wCAAwC,MAAM,CAAC,MAAM,CAAC,+BAA+B,CACtF,CAAC;IACJ,CAAC;IACD,gGAAgG;IAChG,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACb,wCAAwC,MAAM,kDAAkD,CACjG,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,UAAU,IAAI,MAAM,EAAE,CAAC;AACvC,CAAC"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@sovecom/module-sdk",
+  "version": "1.0.0-rc.1",
+  "license": "AGPL-3.0-only",
+  "description": "Public author-facing contract SDK for the SovEcom module ecosystem",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/asifwanders/SovEcom.git",
+    "directory": "packages/module-sdk"
+  },
+  "homepage": "https://github.com/asifwanders/SovEcom#readme",
+  "bugs": {
+    "url": "https://github.com/asifwanders/SovEcom/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "semver": "^7.8.4",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "@types/semver": "^7.7.1",
+    "typescript": "^5.4.0",
+    "vitest": "^4.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "eslint src --ext .ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist"
+  }
+}