@agentic-kit/pi 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +23 -0
- package/README.md +126 -0
- package/app-workspace.d.ts +16 -0
- package/app-workspace.js +145 -0
- package/confirm-gate.d.ts +13 -0
- package/confirm-gate.js +51 -0
- package/context.d.ts +39 -0
- package/context.js +251 -0
- package/db-probe.d.ts +29 -0
- package/db-probe.js +50 -0
- package/esm/app-workspace.d.ts +16 -0
- package/esm/app-workspace.js +134 -0
- package/esm/confirm-gate.d.ts +13 -0
- package/esm/confirm-gate.js +48 -0
- package/esm/context.d.ts +39 -0
- package/esm/context.js +242 -0
- package/esm/db-probe.d.ts +29 -0
- package/esm/db-probe.js +47 -0
- package/esm/host.d.ts +55 -0
- package/esm/host.js +20 -0
- package/esm/index.d.ts +11 -0
- package/esm/index.js +48 -0
- package/esm/policy/add-policies-to-table.d.ts +26 -0
- package/esm/policy/add-policies-to-table.js +66 -0
- package/esm/policy/provision-helpers.d.ts +38 -0
- package/esm/policy/provision-helpers.js +50 -0
- package/esm/provision-database/create-database-provision.d.ts +11 -0
- package/esm/provision-database/create-database-provision.js +48 -0
- package/esm/provision-database/credential.d.ts +14 -0
- package/esm/provision-database/credential.js +19 -0
- package/esm/provision-database/env-file.d.ts +37 -0
- package/esm/provision-database/env-file.js +85 -0
- package/esm/provision-database/modules.d.ts +2 -0
- package/esm/provision-database/modules.js +40 -0
- package/esm/provision-database/pg-fixups.d.ts +16 -0
- package/esm/provision-database/pg-fixups.js +132 -0
- package/esm/records/meta.d.ts +41 -0
- package/esm/records/meta.js +170 -0
- package/esm/run-codegen/barrels.d.ts +3 -0
- package/esm/run-codegen/barrels.js +48 -0
- package/esm/run-codegen/endpoints.d.ts +8 -0
- package/esm/run-codegen/endpoints.js +46 -0
- package/esm/schema-resolve.d.ts +23 -0
- package/esm/schema-resolve.js +69 -0
- package/esm/tool-schema.d.ts +3 -0
- package/esm/tool-schema.js +10 -0
- package/esm/tools/add-policies.d.ts +8 -0
- package/esm/tools/add-policies.js +96 -0
- package/esm/tools/add-records.d.ts +14 -0
- package/esm/tools/add-records.js +124 -0
- package/esm/tools/add-relation-schema.d.ts +30 -0
- package/esm/tools/add-relation-schema.js +58 -0
- package/esm/tools/add-relation.d.ts +10 -0
- package/esm/tools/add-relation.js +91 -0
- package/esm/tools/describe-schema.d.ts +18 -0
- package/esm/tools/describe-schema.js +132 -0
- package/esm/tools/mutations.d.ts +14 -0
- package/esm/tools/mutations.js +235 -0
- package/esm/tools/provision-blueprint.d.ts +22 -0
- package/esm/tools/provision-blueprint.js +111 -0
- package/esm/tools/provision-database.d.ts +14 -0
- package/esm/tools/provision-database.js +251 -0
- package/esm/tools/run-codegen.d.ts +11 -0
- package/esm/tools/run-codegen.js +139 -0
- package/esm/tools/templates.d.ts +49 -0
- package/esm/tools/templates.js +337 -0
- package/host.d.ts +55 -0
- package/host.js +25 -0
- package/index.d.ts +11 -0
- package/index.js +60 -0
- package/package.json +51 -0
- package/policy/add-policies-to-table.d.ts +26 -0
- package/policy/add-policies-to-table.js +71 -0
- package/policy/provision-helpers.d.ts +38 -0
- package/policy/provision-helpers.js +58 -0
- package/provision-database/create-database-provision.d.ts +11 -0
- package/provision-database/create-database-provision.js +51 -0
- package/provision-database/credential.d.ts +14 -0
- package/provision-database/credential.js +22 -0
- package/provision-database/env-file.d.ts +37 -0
- package/provision-database/env-file.js +91 -0
- package/provision-database/modules.d.ts +2 -0
- package/provision-database/modules.js +43 -0
- package/provision-database/pg-fixups.d.ts +16 -0
- package/provision-database/pg-fixups.js +170 -0
- package/records/meta.d.ts +41 -0
- package/records/meta.js +175 -0
- package/run-codegen/barrels.d.ts +3 -0
- package/run-codegen/barrels.js +54 -0
- package/run-codegen/endpoints.d.ts +8 -0
- package/run-codegen/endpoints.js +51 -0
- package/schema-resolve.d.ts +23 -0
- package/schema-resolve.js +75 -0
- package/tool-schema.d.ts +3 -0
- package/tool-schema.js +13 -0
- package/tools/add-policies.d.ts +8 -0
- package/tools/add-policies.js +99 -0
- package/tools/add-records.d.ts +14 -0
- package/tools/add-records.js +127 -0
- package/tools/add-relation-schema.d.ts +30 -0
- package/tools/add-relation-schema.js +62 -0
- package/tools/add-relation.d.ts +10 -0
- package/tools/add-relation.js +94 -0
- package/tools/describe-schema.d.ts +18 -0
- package/tools/describe-schema.js +135 -0
- package/tools/mutations.d.ts +14 -0
- package/tools/mutations.js +238 -0
- package/tools/provision-blueprint.d.ts +22 -0
- package/tools/provision-blueprint.js +114 -0
- package/tools/provision-database.d.ts +14 -0
- package/tools/provision-database.js +257 -0
- package/tools/run-codegen.d.ts +11 -0
- package/tools/run-codegen.js +143 -0
- package/tools/templates.d.ts +49 -0
- package/tools/templates.js +341 -0
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
export type CrudOperation = 'create' | 'read' | 'update' | 'delete';
|
|
2
|
+
export interface OperationPolicyConfig {
|
|
3
|
+
roleName: string;
|
|
4
|
+
isPermissive: boolean;
|
|
5
|
+
policyData: Record<string, unknown>;
|
|
6
|
+
isCustomized: boolean;
|
|
7
|
+
}
|
|
8
|
+
export interface CrudPolicyConfigs {
|
|
9
|
+
create: OperationPolicyConfig;
|
|
10
|
+
read: OperationPolicyConfig;
|
|
11
|
+
update: OperationPolicyConfig;
|
|
12
|
+
delete: OperationPolicyConfig;
|
|
13
|
+
}
|
|
14
|
+
export declare const CRUD_OPERATIONS: CrudOperation[];
|
|
15
|
+
export type GrantPrivilege = [string, string | string[]];
|
|
16
|
+
export interface GrantEntry {
|
|
17
|
+
roles: string[];
|
|
18
|
+
privileges: GrantPrivilege[];
|
|
19
|
+
}
|
|
20
|
+
export interface PolicyEntry {
|
|
21
|
+
$type: string;
|
|
22
|
+
data?: Record<string, unknown>;
|
|
23
|
+
privileges?: string[];
|
|
24
|
+
policy_role?: string;
|
|
25
|
+
permissive?: boolean;
|
|
26
|
+
policy_name?: string;
|
|
27
|
+
}
|
|
28
|
+
export declare const ALL_CRUD_PRIVILEGES: GrantPrivilege[];
|
|
29
|
+
export declare function crudOpToPrivilege(op: CrudOperation): string;
|
|
30
|
+
export declare function crudOpsToPrivileges(ops: readonly CrudOperation[]): string[];
|
|
31
|
+
export declare function buildGrants(roles?: string[], privileges?: GrantPrivilege[]): GrantEntry[];
|
|
32
|
+
export declare function buildPolicyEntry(type: string, opts?: Partial<Omit<PolicyEntry, '$type'>>): PolicyEntry;
|
|
33
|
+
export interface OperationGroup {
|
|
34
|
+
roleName: string;
|
|
35
|
+
isPermissive: boolean;
|
|
36
|
+
privileges: string[];
|
|
37
|
+
}
|
|
38
|
+
export declare function groupOperationsByConfig(enabledOperations: readonly CrudOperation[], operations: CrudPolicyConfigs): OperationGroup[];
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.ALL_CRUD_PRIVILEGES = exports.CRUD_OPERATIONS = void 0;
|
|
4
|
+
exports.crudOpToPrivilege = crudOpToPrivilege;
|
|
5
|
+
exports.crudOpsToPrivileges = crudOpsToPrivileges;
|
|
6
|
+
exports.buildGrants = buildGrants;
|
|
7
|
+
exports.buildPolicyEntry = buildPolicyEntry;
|
|
8
|
+
exports.groupOperationsByConfig = groupOperationsByConfig;
|
|
9
|
+
exports.CRUD_OPERATIONS = ['create', 'read', 'update', 'delete'];
|
|
10
|
+
exports.ALL_CRUD_PRIVILEGES = [
|
|
11
|
+
['select', '*'],
|
|
12
|
+
['insert', '*'],
|
|
13
|
+
['update', '*'],
|
|
14
|
+
['delete', '*'],
|
|
15
|
+
];
|
|
16
|
+
const CRUD_OP_TO_LOWER_PRIVILEGE = {
|
|
17
|
+
create: 'insert',
|
|
18
|
+
read: 'select',
|
|
19
|
+
update: 'update',
|
|
20
|
+
delete: 'delete',
|
|
21
|
+
};
|
|
22
|
+
function crudOpToPrivilege(op) {
|
|
23
|
+
return CRUD_OP_TO_LOWER_PRIVILEGE[op];
|
|
24
|
+
}
|
|
25
|
+
function crudOpsToPrivileges(ops) {
|
|
26
|
+
return ops.map(crudOpToPrivilege);
|
|
27
|
+
}
|
|
28
|
+
function buildGrants(roles = ['authenticated'], privileges = exports.ALL_CRUD_PRIVILEGES) {
|
|
29
|
+
return [{ roles, privileges }];
|
|
30
|
+
}
|
|
31
|
+
function buildPolicyEntry(type, opts = {}) {
|
|
32
|
+
const entry = { $type: type };
|
|
33
|
+
if (opts.data && Object.keys(opts.data).length > 0)
|
|
34
|
+
entry.data = opts.data;
|
|
35
|
+
if (opts.privileges && opts.privileges.length > 0)
|
|
36
|
+
entry.privileges = opts.privileges;
|
|
37
|
+
if (opts.policy_role)
|
|
38
|
+
entry.policy_role = opts.policy_role;
|
|
39
|
+
if (opts.permissive !== undefined)
|
|
40
|
+
entry.permissive = opts.permissive;
|
|
41
|
+
if (opts.policy_name)
|
|
42
|
+
entry.policy_name = opts.policy_name;
|
|
43
|
+
return entry;
|
|
44
|
+
}
|
|
45
|
+
function groupOperationsByConfig(enabledOperations, operations) {
|
|
46
|
+
const groupMap = new Map();
|
|
47
|
+
for (const op of enabledOperations) {
|
|
48
|
+
const config = operations[op];
|
|
49
|
+
const key = `${config.roleName}:${config.isPermissive}`;
|
|
50
|
+
let group = groupMap.get(key);
|
|
51
|
+
if (!group) {
|
|
52
|
+
group = { roleName: config.roleName, isPermissive: config.isPermissive, privileges: [] };
|
|
53
|
+
groupMap.set(key, group);
|
|
54
|
+
}
|
|
55
|
+
group.privileges.push(...crudOpsToPrivileges([op]));
|
|
56
|
+
}
|
|
57
|
+
return [...groupMap.values()];
|
|
58
|
+
}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import type { ProvisionModule } from './modules';
|
|
2
|
+
export declare function createDatabaseProvision(args: {
|
|
3
|
+
endpoint: string;
|
|
4
|
+
bearer: string;
|
|
5
|
+
databaseName: string;
|
|
6
|
+
domain: string;
|
|
7
|
+
ownerId: string;
|
|
8
|
+
modules: ProvisionModule[];
|
|
9
|
+
}): Promise<{
|
|
10
|
+
databaseId: string;
|
|
11
|
+
}>;
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
// Provision a database through the modules endpoint's createDatabaseProvisionModule
|
|
3
|
+
// mutation — an insert into database_provision_modules whose BEFORE INSERT trigger
|
|
4
|
+
// creates the database, domain, API, and module set before the row returns (the
|
|
5
|
+
// same contract constructive-client's admin app uses). The retired requestDatabase
|
|
6
|
+
// mutation only ever existed on dev builds of the api endpoint; production
|
|
7
|
+
// deployments (modules.launchql.dev) expose this one. bootstrapUser: true copies
|
|
8
|
+
// the owner into the new database so its per-DB API recognizes the account user.
|
|
9
|
+
// The generated ORM's default adapter is plain fetch, so the SDK's FetchAdapter is
|
|
10
|
+
// injected to keep *.localhost DNS/Host routing working in Node.
|
|
11
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
12
|
+
exports.createDatabaseProvision = createDatabaseProvision;
|
|
13
|
+
const sdk_1 = require("@constructive-io/sdk");
|
|
14
|
+
async function createDatabaseProvision(args) {
|
|
15
|
+
const db = sdk_1.modules.createClient({
|
|
16
|
+
adapter: new sdk_1.api.FetchAdapter(args.endpoint, {
|
|
17
|
+
Authorization: `Bearer ${args.bearer}`,
|
|
18
|
+
}),
|
|
19
|
+
});
|
|
20
|
+
const result = await db.databaseProvisionModule
|
|
21
|
+
.create({
|
|
22
|
+
data: {
|
|
23
|
+
databaseName: args.databaseName,
|
|
24
|
+
subdomain: args.databaseName,
|
|
25
|
+
domain: args.domain,
|
|
26
|
+
ownerId: args.ownerId,
|
|
27
|
+
modules: args.modules,
|
|
28
|
+
bootstrapUser: true,
|
|
29
|
+
},
|
|
30
|
+
select: {
|
|
31
|
+
id: true,
|
|
32
|
+
databaseId: true,
|
|
33
|
+
status: true,
|
|
34
|
+
errorMessage: true,
|
|
35
|
+
completedAt: true,
|
|
36
|
+
},
|
|
37
|
+
})
|
|
38
|
+
.unwrap();
|
|
39
|
+
const record = result.createDatabaseProvisionModule?.databaseProvisionModule;
|
|
40
|
+
if (!record)
|
|
41
|
+
throw new Error('createDatabaseProvisionModule returned no provision record.');
|
|
42
|
+
if (record.status === 'failed') {
|
|
43
|
+
throw new Error(record.errorMessage ?? 'provisioning failed');
|
|
44
|
+
}
|
|
45
|
+
if (record.status !== 'completed') {
|
|
46
|
+
throw new Error(record.errorMessage ?? `provisioning did not complete (status: ${record.status ?? 'unknown'})`);
|
|
47
|
+
}
|
|
48
|
+
if (!record.databaseId)
|
|
49
|
+
throw new Error('provisioning completed but returned no databaseId.');
|
|
50
|
+
return { databaseId: record.databaseId };
|
|
51
|
+
}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
export type AccountCredential = {
|
|
2
|
+
userId: string;
|
|
3
|
+
accessToken: string;
|
|
4
|
+
apiKey?: string;
|
|
5
|
+
};
|
|
6
|
+
export type ProvisionCredential = {
|
|
7
|
+
mode: 'account';
|
|
8
|
+
ownerId: string;
|
|
9
|
+
bearer: string;
|
|
10
|
+
} | {
|
|
11
|
+
mode: 'error';
|
|
12
|
+
reason: string;
|
|
13
|
+
};
|
|
14
|
+
export declare function selectProvisionCredential(account: AccountCredential | null | undefined): ProvisionCredential;
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
// Pure: decide which credential authenticates a project's provisioning. Under the
|
|
3
|
+
// account gate a signed-in session is guaranteed, so every new project provisions
|
|
4
|
+
// UNDER the account (account-owned + enumerable): the database's owner_id is the
|
|
5
|
+
// account's own userId, and the account's API key (falling back to its session
|
|
6
|
+
// token) is the bearer that authenticates the provision mutation and lands in the
|
|
7
|
+
// project .env as ACCESS_TOKEN (refreshed on every provision run, including the
|
|
8
|
+
// skip path). A signed-in session with no usable bearer (keychain locked) is an
|
|
9
|
+
// explicit error, never a silent throwaway owner.
|
|
10
|
+
// Side-effect-free so the branch is unit-testable without runtime/network.
|
|
11
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
12
|
+
exports.selectProvisionCredential = selectProvisionCredential;
|
|
13
|
+
function selectProvisionCredential(account) {
|
|
14
|
+
const bearer = account?.apiKey ?? account?.accessToken;
|
|
15
|
+
if (account?.userId && bearer) {
|
|
16
|
+
return { mode: 'account', ownerId: account.userId, bearer };
|
|
17
|
+
}
|
|
18
|
+
return {
|
|
19
|
+
mode: 'error',
|
|
20
|
+
reason: 'No usable account credential. Sign in (or unlock your session) before provisioning a database.',
|
|
21
|
+
};
|
|
22
|
+
}
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
export type EnvVars = Record<string, string>;
|
|
2
|
+
/**
|
|
3
|
+
* Upsert `vars` into the existing `.env` `content`. Existing keys are replaced
|
|
4
|
+
* in place (preserving surrounding lines/comments); new keys are appended.
|
|
5
|
+
* Returns the new file body, trailing-newline-terminated.
|
|
6
|
+
*/
|
|
7
|
+
export declare function mergeEnv(content: string, vars: EnvVars): string;
|
|
8
|
+
/** The credential keys provision_database owns in a project's .env. */
|
|
9
|
+
export declare const PROVISION_ENV_KEYS: readonly ["DATABASE_ID", "DATABASE_NAME", "OWNER_ID", "ACCESS_TOKEN", "PGDATABASE", "API_ENDPOINT", "MODULES_ENDPOINT"];
|
|
10
|
+
/**
|
|
11
|
+
* Keys archived as comments on reprovision — the binding identity: which
|
|
12
|
+
* database, under whom, on which backend. ACCESS_TOKEN is the account login
|
|
13
|
+
* token, identical across bindings, so it is overwritten in place rather than
|
|
14
|
+
* archived.
|
|
15
|
+
*/
|
|
16
|
+
export declare const ARCHIVED_BINDING_KEYS: readonly ["DATABASE_ID", "DATABASE_NAME", "OWNER_ID", "PGDATABASE", "API_ENDPOINT", "MODULES_ENDPOINT"];
|
|
17
|
+
/**
|
|
18
|
+
* Build the provisioning credential block written to a project's .env. The
|
|
19
|
+
* endpoint pins record which backend owns this binding — outside-app consumers
|
|
20
|
+
* (verify-feature.sh, skill scripts, dev-server shells) resolve them instead of
|
|
21
|
+
* falling back to localhost defaults when the app targets a hosted backend.
|
|
22
|
+
*/
|
|
23
|
+
export declare function provisionEnvVars(args: {
|
|
24
|
+
databaseId: string;
|
|
25
|
+
databaseName: string;
|
|
26
|
+
ownerId: string;
|
|
27
|
+
accessToken: string;
|
|
28
|
+
apiEndpoint: string;
|
|
29
|
+
modulesEndpoint: string;
|
|
30
|
+
}): EnvVars;
|
|
31
|
+
/**
|
|
32
|
+
* Comment out the given keys in place (`# archived <date>: KEY=value`) so a
|
|
33
|
+
* reprovision keeps the previous binding readable in the file instead of
|
|
34
|
+
* silently overwriting it. Every other line — including existing comments and
|
|
35
|
+
* already-archived entries — passes through untouched.
|
|
36
|
+
*/
|
|
37
|
+
export declare function archiveBindingKeys(content: string, keys: readonly string[], archivedOn: string): string;
|
|
@@ -0,0 +1,91 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
// Pure .env merge — used by provision_database to persist provisioning
|
|
3
|
+
// credentials without clobbering existing keys: replace a key in place if
|
|
4
|
+
// present, else append.
|
|
5
|
+
// Kept side-effect-free so it is unit-testable (the tool does the fs write).
|
|
6
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
7
|
+
exports.ARCHIVED_BINDING_KEYS = exports.PROVISION_ENV_KEYS = void 0;
|
|
8
|
+
exports.mergeEnv = mergeEnv;
|
|
9
|
+
exports.provisionEnvVars = provisionEnvVars;
|
|
10
|
+
exports.archiveBindingKeys = archiveBindingKeys;
|
|
11
|
+
/**
|
|
12
|
+
* Upsert `vars` into the existing `.env` `content`. Existing keys are replaced
|
|
13
|
+
* in place (preserving surrounding lines/comments); new keys are appended.
|
|
14
|
+
* Returns the new file body, trailing-newline-terminated.
|
|
15
|
+
*/
|
|
16
|
+
function mergeEnv(content, vars) {
|
|
17
|
+
let out = content;
|
|
18
|
+
for (const [key, val] of Object.entries(vars)) {
|
|
19
|
+
// Escape the key for the regex, and use a replacement function so `$`
|
|
20
|
+
// sequences in the value are never treated as replacement specials.
|
|
21
|
+
const escapedKey = key.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
|
|
22
|
+
const regex = new RegExp(`^${escapedKey}=.*`, 'm');
|
|
23
|
+
if (regex.test(out))
|
|
24
|
+
out = out.replace(regex, () => `${key}=${val}`);
|
|
25
|
+
else
|
|
26
|
+
out += `\n${key}=${val}`;
|
|
27
|
+
}
|
|
28
|
+
return out.trim() + '\n';
|
|
29
|
+
}
|
|
30
|
+
/** The credential keys provision_database owns in a project's .env. */
|
|
31
|
+
exports.PROVISION_ENV_KEYS = [
|
|
32
|
+
'DATABASE_ID',
|
|
33
|
+
'DATABASE_NAME',
|
|
34
|
+
'OWNER_ID',
|
|
35
|
+
'ACCESS_TOKEN',
|
|
36
|
+
'PGDATABASE',
|
|
37
|
+
'API_ENDPOINT',
|
|
38
|
+
'MODULES_ENDPOINT',
|
|
39
|
+
];
|
|
40
|
+
/**
|
|
41
|
+
* Keys archived as comments on reprovision — the binding identity: which
|
|
42
|
+
* database, under whom, on which backend. ACCESS_TOKEN is the account login
|
|
43
|
+
* token, identical across bindings, so it is overwritten in place rather than
|
|
44
|
+
* archived.
|
|
45
|
+
*/
|
|
46
|
+
exports.ARCHIVED_BINDING_KEYS = [
|
|
47
|
+
'DATABASE_ID',
|
|
48
|
+
'DATABASE_NAME',
|
|
49
|
+
'OWNER_ID',
|
|
50
|
+
'PGDATABASE',
|
|
51
|
+
'API_ENDPOINT',
|
|
52
|
+
'MODULES_ENDPOINT',
|
|
53
|
+
];
|
|
54
|
+
/**
|
|
55
|
+
* Build the provisioning credential block written to a project's .env. The
|
|
56
|
+
* endpoint pins record which backend owns this binding — outside-app consumers
|
|
57
|
+
* (verify-feature.sh, skill scripts, dev-server shells) resolve them instead of
|
|
58
|
+
* falling back to localhost defaults when the app targets a hosted backend.
|
|
59
|
+
*/
|
|
60
|
+
function provisionEnvVars(args) {
|
|
61
|
+
return {
|
|
62
|
+
DATABASE_ID: args.databaseId,
|
|
63
|
+
DATABASE_NAME: args.databaseName,
|
|
64
|
+
OWNER_ID: args.ownerId,
|
|
65
|
+
ACCESS_TOKEN: args.accessToken,
|
|
66
|
+
PGDATABASE: args.databaseName,
|
|
67
|
+
API_ENDPOINT: args.apiEndpoint,
|
|
68
|
+
MODULES_ENDPOINT: args.modulesEndpoint,
|
|
69
|
+
};
|
|
70
|
+
}
|
|
71
|
+
/**
|
|
72
|
+
* Comment out the given keys in place (`# archived <date>: KEY=value`) so a
|
|
73
|
+
* reprovision keeps the previous binding readable in the file instead of
|
|
74
|
+
* silently overwriting it. Every other line — including existing comments and
|
|
75
|
+
* already-archived entries — passes through untouched.
|
|
76
|
+
*/
|
|
77
|
+
function archiveBindingKeys(content, keys, archivedOn) {
|
|
78
|
+
const keySet = new Set(keys);
|
|
79
|
+
return content
|
|
80
|
+
.split('\n')
|
|
81
|
+
.map((line) => {
|
|
82
|
+
if (line.trimStart().startsWith('#'))
|
|
83
|
+
return line;
|
|
84
|
+
const eq = line.indexOf('=');
|
|
85
|
+
if (eq === -1)
|
|
86
|
+
return line;
|
|
87
|
+
const key = line.slice(0, eq).trim();
|
|
88
|
+
return keySet.has(key) ? `# archived ${archivedOn}: ${line.trim()}` : line;
|
|
89
|
+
})
|
|
90
|
+
.join('\n');
|
|
91
|
+
}
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.DEFAULT_PROVISION_MODULES = void 0;
|
|
4
|
+
exports.DEFAULT_PROVISION_MODULES = [
|
|
5
|
+
'users_module',
|
|
6
|
+
'membership_types_module',
|
|
7
|
+
['permissions_module', { scope: 'app' }],
|
|
8
|
+
['permissions_module', { scope: 'org' }],
|
|
9
|
+
['limits_module', { scope: 'app' }],
|
|
10
|
+
['limits_module', { scope: 'org' }],
|
|
11
|
+
['levels_module', { scope: 'app' }],
|
|
12
|
+
['levels_module', { scope: 'org' }],
|
|
13
|
+
['memberships_module', { scope: 'app' }],
|
|
14
|
+
['memberships_module', { scope: 'org' }],
|
|
15
|
+
'sessions_module',
|
|
16
|
+
'user_state_module',
|
|
17
|
+
'user_credentials_module',
|
|
18
|
+
['internal_secrets_module', { scope: 'app' }],
|
|
19
|
+
'emails_module',
|
|
20
|
+
'rls_module',
|
|
21
|
+
'user_auth_module',
|
|
22
|
+
'session_secrets_module',
|
|
23
|
+
'rate_limits_module',
|
|
24
|
+
'connected_accounts_module',
|
|
25
|
+
['identity_providers_module', { scope: 'app' }],
|
|
26
|
+
'webauthn_credentials_module',
|
|
27
|
+
'webauthn_auth_module',
|
|
28
|
+
'phone_numbers_module',
|
|
29
|
+
['profiles_module', { scope: 'app' }],
|
|
30
|
+
['profiles_module', { scope: 'org' }],
|
|
31
|
+
['hierarchy_module', { scope: 'org' }],
|
|
32
|
+
['invites_module', { scope: 'app' }],
|
|
33
|
+
['invites_module', { scope: 'org' }],
|
|
34
|
+
// Mirrors constructive-client: api_name links storage to the same api-<slug>
|
|
35
|
+
// endpoint the generated SDK targets (without it uploads fail with "not
|
|
36
|
+
// enabled for this endpoint"), prefix keeps app_buckets/app_files names off
|
|
37
|
+
// user tables, and buckets seeds the public bucket row uploads need.
|
|
38
|
+
[
|
|
39
|
+
'storage_module',
|
|
40
|
+
{ scope: 'app', api_name: 'api', prefix: 'app', buckets: [{ key: 'public', is_public: true }] },
|
|
41
|
+
],
|
|
42
|
+
'devices_module',
|
|
43
|
+
];
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
export type FixupResult = {
|
|
2
|
+
applied: boolean;
|
|
3
|
+
note: string;
|
|
4
|
+
};
|
|
5
|
+
export type PgEnv = {
|
|
6
|
+
host?: string;
|
|
7
|
+
port?: string;
|
|
8
|
+
user?: string;
|
|
9
|
+
password?: string;
|
|
10
|
+
};
|
|
11
|
+
export declare function parsePgpmEnv(stdout: string): PgEnv;
|
|
12
|
+
export declare function resolvePgEnv(): Promise<PgEnv | null>;
|
|
13
|
+
export declare function applySqlFixups(args: {
|
|
14
|
+
databaseName: string;
|
|
15
|
+
physicalDb: string;
|
|
16
|
+
}): Promise<FixupResult>;
|
|
@@ -0,0 +1,170 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
// Post-provision SQL fixups for a freshly provisioned database.
|
|
3
|
+
//
|
|
4
|
+
// Two things must happen at the Postgres level that the provisioning GraphQL API
|
|
5
|
+
// does not do for us:
|
|
6
|
+
//
|
|
7
|
+
// 1. Naming settings — `constructive.simple_schema_names` and
|
|
8
|
+
// `schema_use_underscores` make later `provision_blueprint` calls create an
|
|
9
|
+
// `app_public` schema (which resolveSchemaId looks for) instead of a
|
|
10
|
+
// hyphenated `<db>-<hex>-app-public` one. These ALTER DATABASE settings
|
|
11
|
+
// PERSIST, so we set them once here, before any blueprint construction.
|
|
12
|
+
//
|
|
13
|
+
// 2. Membership defaults — new sign-ups otherwise land with
|
|
14
|
+
// is_approved=false/is_verified=false, the AuthzEntityMembership policy then
|
|
15
|
+
// denies every insert/select, and CRUD rows silently never persist
|
|
16
|
+
// (BLUEPRINT-PENDING-001). We flip the defaults (future sign-ups) AND any
|
|
17
|
+
// memberships already created during provisioning.
|
|
18
|
+
//
|
|
19
|
+
// All SQL targets the PHYSICAL control-plane database (`constructive`), NOT the
|
|
20
|
+
// app's database name — that name is only a schema prefix (MEMBERSHIP-DB-001).
|
|
21
|
+
//
|
|
22
|
+
// Connection creds come from the ambient PG* env vars, falling back to sourcing
|
|
23
|
+
// `pgpm env` (the same mechanism the old `eval "$(pgpm env)"` shell step used).
|
|
24
|
+
// If neither yields a connection, provisioning still succeeded — we return a
|
|
25
|
+
// note so the tool can warn the user that sign-in/CRUD may need a manual fixup.
|
|
26
|
+
var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
|
|
27
|
+
if (k2 === undefined) k2 = k;
|
|
28
|
+
var desc = Object.getOwnPropertyDescriptor(m, k);
|
|
29
|
+
if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
|
|
30
|
+
desc = { enumerable: true, get: function() { return m[k]; } };
|
|
31
|
+
}
|
|
32
|
+
Object.defineProperty(o, k2, desc);
|
|
33
|
+
}) : (function(o, m, k, k2) {
|
|
34
|
+
if (k2 === undefined) k2 = k;
|
|
35
|
+
o[k2] = m[k];
|
|
36
|
+
}));
|
|
37
|
+
var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
|
|
38
|
+
Object.defineProperty(o, "default", { enumerable: true, value: v });
|
|
39
|
+
}) : function(o, v) {
|
|
40
|
+
o["default"] = v;
|
|
41
|
+
});
|
|
42
|
+
var __importStar = (this && this.__importStar) || (function () {
|
|
43
|
+
var ownKeys = function(o) {
|
|
44
|
+
ownKeys = Object.getOwnPropertyNames || function (o) {
|
|
45
|
+
var ar = [];
|
|
46
|
+
for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
|
|
47
|
+
return ar;
|
|
48
|
+
};
|
|
49
|
+
return ownKeys(o);
|
|
50
|
+
};
|
|
51
|
+
return function (mod) {
|
|
52
|
+
if (mod && mod.__esModule) return mod;
|
|
53
|
+
var result = {};
|
|
54
|
+
if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
|
|
55
|
+
__setModuleDefault(result, mod);
|
|
56
|
+
return result;
|
|
57
|
+
};
|
|
58
|
+
})();
|
|
59
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
60
|
+
exports.parsePgpmEnv = parsePgpmEnv;
|
|
61
|
+
exports.resolvePgEnv = resolvePgEnv;
|
|
62
|
+
exports.applySqlFixups = applySqlFixups;
|
|
63
|
+
const node_child_process_1 = require("node:child_process");
|
|
64
|
+
const node_util_1 = require("node:util");
|
|
65
|
+
const execFileAsync = (0, node_util_1.promisify)(node_child_process_1.execFile);
|
|
66
|
+
// Parse `pgpm env` output. It prints shell assignments (optionally `export`-
|
|
67
|
+
// prefixed), one per line: `export PGHOST=localhost`. Quotes are stripped.
|
|
68
|
+
function parsePgpmEnv(stdout) {
|
|
69
|
+
const env = {};
|
|
70
|
+
for (const rawLine of stdout.split('\n')) {
|
|
71
|
+
const line = rawLine.trim().replace(/^export\s+/, '');
|
|
72
|
+
const eq = line.indexOf('=');
|
|
73
|
+
if (eq === -1)
|
|
74
|
+
continue;
|
|
75
|
+
const key = line.slice(0, eq).trim();
|
|
76
|
+
let value = line.slice(eq + 1).trim();
|
|
77
|
+
if ((value.startsWith('"') && value.endsWith('"')) ||
|
|
78
|
+
(value.startsWith("'") && value.endsWith("'"))) {
|
|
79
|
+
value = value.slice(1, -1);
|
|
80
|
+
}
|
|
81
|
+
env[key] = value;
|
|
82
|
+
}
|
|
83
|
+
return {
|
|
84
|
+
host: env.PGHOST,
|
|
85
|
+
port: env.PGPORT,
|
|
86
|
+
user: env.PGUSER,
|
|
87
|
+
password: env.PGPASSWORD,
|
|
88
|
+
};
|
|
89
|
+
}
|
|
90
|
+
async function resolvePgEnv() {
|
|
91
|
+
if (process.env.PGHOST) {
|
|
92
|
+
return {
|
|
93
|
+
host: process.env.PGHOST,
|
|
94
|
+
port: process.env.PGPORT,
|
|
95
|
+
user: process.env.PGUSER,
|
|
96
|
+
password: process.env.PGPASSWORD,
|
|
97
|
+
};
|
|
98
|
+
}
|
|
99
|
+
try {
|
|
100
|
+
const { stdout } = await execFileAsync('pgpm', ['env'], { timeout: 15_000 });
|
|
101
|
+
const parsed = parsePgpmEnv(stdout);
|
|
102
|
+
return parsed.host ? parsed : null;
|
|
103
|
+
}
|
|
104
|
+
catch {
|
|
105
|
+
return null;
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
// Find the memberships schema for this app. Schema names use hyphens locally
|
|
109
|
+
// (`<db>-<hex>-memberships-public`) but may use underscores when the naming
|
|
110
|
+
// settings are active — match both, scoped to this app's name prefix.
|
|
111
|
+
const MEMBERSHIPS_SCHEMA_QUERY = `
|
|
112
|
+
SELECT schema_name FROM information_schema.schemata
|
|
113
|
+
WHERE (schema_name LIKE '%memberships-public' OR schema_name LIKE '%memberships_public')
|
|
114
|
+
AND (schema_name LIKE $1 OR schema_name LIKE $2)
|
|
115
|
+
ORDER BY schema_name DESC LIMIT 1`;
|
|
116
|
+
async function applySqlFixups(args) {
|
|
117
|
+
const pgEnv = await resolvePgEnv();
|
|
118
|
+
if (!pgEnv) {
|
|
119
|
+
return {
|
|
120
|
+
applied: false,
|
|
121
|
+
note: 'Could not reach Postgres (no PGHOST and `pgpm env` unavailable). Database provisioned, but membership defaults were not enabled — sign-in/CRUD may fail until the constructive DB is fixed up manually.',
|
|
122
|
+
};
|
|
123
|
+
}
|
|
124
|
+
// pg is dynamically imported so the main bundle never loads it unless a
|
|
125
|
+
// provision actually runs with Postgres access. The import lives inside the
|
|
126
|
+
// try: fixups are best-effort, so even a broken pg module must degrade to a
|
|
127
|
+
// note instead of failing the tool after the database is already provisioned.
|
|
128
|
+
let pool;
|
|
129
|
+
try {
|
|
130
|
+
const { Pool } = await Promise.resolve().then(() => __importStar(require('pg')));
|
|
131
|
+
pool = new Pool({
|
|
132
|
+
host: pgEnv.host,
|
|
133
|
+
port: pgEnv.port ? Number(pgEnv.port) : undefined,
|
|
134
|
+
user: pgEnv.user,
|
|
135
|
+
password: pgEnv.password,
|
|
136
|
+
database: args.physicalDb,
|
|
137
|
+
});
|
|
138
|
+
const db = args.physicalDb;
|
|
139
|
+
// Persistent naming settings — so future provision_blueprint calls land an
|
|
140
|
+
// `app_public` schema resolveSchemaId can find.
|
|
141
|
+
await pool.query(`ALTER DATABASE "${db}" SET constructive.simple_schema_names = 'true'`);
|
|
142
|
+
await pool.query(`ALTER DATABASE "${db}" SET constructive.schema_use_underscores = 'true'`);
|
|
143
|
+
const schemaResult = await pool.query(MEMBERSHIPS_SCHEMA_QUERY, [
|
|
144
|
+
`${args.databaseName}-%`,
|
|
145
|
+
`${args.databaseName}\\_%`,
|
|
146
|
+
]);
|
|
147
|
+
if (schemaResult.rows.length === 0) {
|
|
148
|
+
return {
|
|
149
|
+
applied: true,
|
|
150
|
+
note: `Naming settings applied, but no memberships schema was found for "${args.databaseName}" — sign-in may need a manual membership fixup.`,
|
|
151
|
+
};
|
|
152
|
+
}
|
|
153
|
+
const membershipsSchema = schemaResult.rows[0].schema_name;
|
|
154
|
+
await pool.query(`UPDATE "${membershipsSchema}".app_membership_defaults SET is_approved = TRUE, is_verified = TRUE`);
|
|
155
|
+
await pool.query(`UPDATE "${membershipsSchema}".app_memberships
|
|
156
|
+
SET is_approved = TRUE, is_verified = TRUE
|
|
157
|
+
WHERE is_approved = FALSE OR is_verified = FALSE`);
|
|
158
|
+
return { applied: true, note: `Membership defaults enabled (schema: ${membershipsSchema}).` };
|
|
159
|
+
}
|
|
160
|
+
catch (err) {
|
|
161
|
+
const message = err instanceof Error ? err.message : String(err);
|
|
162
|
+
return {
|
|
163
|
+
applied: false,
|
|
164
|
+
note: `Database provisioned, but SQL fixups failed (${message}). Sign-in/CRUD may fail until membership defaults are enabled manually.`,
|
|
165
|
+
};
|
|
166
|
+
}
|
|
167
|
+
finally {
|
|
168
|
+
await pool?.end().catch(() => { });
|
|
169
|
+
}
|
|
170
|
+
}
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
import type { Table, TableInflection } from '@constructive-io/graphql-query/types/schema';
|
|
2
|
+
export declare const META_QUERY = "\n query DbToolsMeta {\n _meta {\n tables {\n name\n query { all one create update delete }\n inflection {\n allRows\n conditionType\n connection\n createInputType\n createPayloadType\n deletePayloadType\n edge\n filterType\n orderByType\n patchType\n tableType\n updatePayloadType\n }\n fields {\n name\n isNotNull\n hasDefault\n type {\n gqlType\n isArray\n pgType\n subtype\n isNotNull\n hasDefault\n }\n }\n }\n }\n }\n";
|
|
3
|
+
type RawType = {
|
|
4
|
+
gqlType: string;
|
|
5
|
+
isArray: boolean;
|
|
6
|
+
modifier?: string | number | null;
|
|
7
|
+
pgAlias?: string | null;
|
|
8
|
+
pgType?: string | null;
|
|
9
|
+
subtype?: string | null;
|
|
10
|
+
typmod?: number | null;
|
|
11
|
+
isNotNull?: boolean | null;
|
|
12
|
+
hasDefault?: boolean | null;
|
|
13
|
+
};
|
|
14
|
+
type RawField = {
|
|
15
|
+
name: string;
|
|
16
|
+
isNotNull?: boolean | null;
|
|
17
|
+
hasDefault?: boolean | null;
|
|
18
|
+
type: RawType;
|
|
19
|
+
};
|
|
20
|
+
type RawInflection = Partial<Record<keyof TableInflection, string | null>>;
|
|
21
|
+
type RawQuery = {
|
|
22
|
+
all: string;
|
|
23
|
+
one?: string | null;
|
|
24
|
+
create?: string | null;
|
|
25
|
+
update?: string | null;
|
|
26
|
+
delete?: string | null;
|
|
27
|
+
};
|
|
28
|
+
export type RawMetaTable = {
|
|
29
|
+
name: string;
|
|
30
|
+
query?: RawQuery | null;
|
|
31
|
+
inflection?: RawInflection | null;
|
|
32
|
+
fields?: (RawField | null)[] | null;
|
|
33
|
+
};
|
|
34
|
+
export type MetaResponse = {
|
|
35
|
+
_meta?: {
|
|
36
|
+
tables?: (RawMetaTable | null)[] | null;
|
|
37
|
+
} | null;
|
|
38
|
+
};
|
|
39
|
+
export declare function cleanTable(meta: RawMetaTable): Table;
|
|
40
|
+
export declare function findMetaTable(tables: RawMetaTable[], requested: string): RawMetaTable | undefined;
|
|
41
|
+
export {};
|